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PREFACE 



This manual describes the configuration of DECnet-20 nodes in a DECnet 
network and details all generation, verification, and installation 
steps. It describes the DECnet-20 configuration tools, the procedures 
to generate DN20 and DN200 subsystems, the NETGEN (NETwork GENeration) 
and NIPGEN (Network Installation Procedure GENerator) program commands 
and parameters, and illustrates a sample system configuration. 

Audience Requirements 

Before reading this manual, you should be fami].iar with the network 
concepts, monitor commands, and utility programs described in the 
following TOPS-20 companion manuals: 

• TOPS-20 Commands Reference Manual (AA-5115B-TM) and its 
update 

• TOPS-20 Operator ' s Command Language Manual (AA-H600A-TM) and 
its update 

• TOPS-20 User Utilities Guide (AA-D850A-TM) and its update 

• TOPS-lO/TOPS-20 Batch Reference Manual (AA-H374A-TK) 

• DECnet-20 User' s Guide (AA-J579A-TM) 

• DECnet-20 System Manager ' s and Operator ' s Guide (AA-J678A-TM) 

• TOPS-20 DN200 Remote Station Guide (AA-H786A-TM) 



Organization 

If you have never performed a network generation and installation 
procedure, be sure to read this manual. Even if you have previously 
done a DECnet-20 installation, the procedures have changed so much 
that you should reread the entire manual. The chapters of this manual 
are summarized below: 

• Chapter 1 provides an overview of the entire system 
configuration procedure, describes the distribution tapes, 
and presents hints for performing a successful configuration. 

• Chapter 2 provides an overview of NETGEN, its commands, their 
parameters, and help and recognition features. 
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• Chapter 3 has an installation overview, with sections on the 
configuration of your DN20 and DN200 processors. 

• Chapter 4 contains an overview of the checkout procedures you 
will use to verify the parts of your network. It describes 
the NIPGEN pronraip., which Generates the coiP-rnand and control 
files used in verifying the system. After successfully 
following the procedures, you will have created the files 
needed for system verification. This chapter ends with 
procedures for editing your system files and for bringing up 
your new monitor and your new network software. 

• Chapter 5 presents procedures for checkout of the software in 
each node. After completing these procedures, your network 
should be up and running. 

• Appendix A summarizes the error messages that may be 
displayed during the system build procedure. 

• Appendix B provides a glossary of hardware and software 
terms . 



Graphic Conventions 

The following conventions are used in this manual in comm.and 
descriptions and examples: 

Convention/Symbol Meaning 

UPPEP CASE Upper case letters indicate actual input 

required in a command string. You must type 
an upper case element in full or with an 
abbreviation acceptable to the system. 

Lower Case Lower case letters in a command string 

indicate an input variable type (name, 

number, for example), not the actual 
variable determined by the operation. 

Spaces Spaces separate elements of a comm.and. Tabs 

or multiple spaces may also be used. Spaces 
must be input where shown. 

Red Red characters indicate information that you 

specify in typing the com.m.and. 

Black Black characters indicate system-supplied 

information. 

C RET ) Indicates the place where you press the KEY 

labelled RETURN or CR. 



labelled ESC, ALT, or SEL. 
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CHAPTER 1 
INTRODUCTION 



DECnet-20 V3.0 is a software product that extends the capabilities of 
TOPS-20 operating systems so that they may be interconnected with 
other DIGITAL operating systems to form networks. The protocols that 
govern message communication under DECnet-20 allow any task running 
under the TOPS-20 operating system to communicate with any other task 
in the network. 

Tasks communicate with each other through nodes in the network. 
Within a network, each node has a name and a unique identifying 
address. You configure your network node by identifying the nodes in 
the network and describing the hardware and software characteristics 
of the nodes. 

Network configuration is a semi-automated procedure that consists of 
the following steps: 

• Creating the directories and data structure needed for 
network generation, and restoring the distribution tapes to 
disk . 

• Running the NETGEN (NETwork GENeration) program to describe 
the DN20 front-end node and the DN200 remote job entry nodes 
in your network. 

• Submitting DN20SYS.CTL and DN20nSYS.CTL to complete node 
generation. These batch jobs use files output by NETGEN. 

• Running the NIPGEN (Network Installation Procedure GENerator) 
program. NIPGEN creates the command and control files used 
to build the network database and to verify and install the 
DN20 and DN200 nodes configured by NETGEN, as well as the KL 
host node and the remote nodes described to NIPGEN. 

• Verifying the connectivity between the configured nodes and 
the adjacent nodes in the network. 
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INTRODUCTION 

1 . 1 HARDWARE/SOFTWARE ENVIRONMENT 

This manual assumes that you will be running DECnet-2n on a 
DECSYSTEM-2040S/2060. The same procedure is followed for each of 
these machines. To run DECnet-20, the Version 5.1 monitor of the 
TOPS-20 operating system must be available. You can either install 
Version 5.1 first and have it running as you do this installation, or, 
if you are upgrading from a previous TOPS-20 or TOPS-20/DECnet-20 
release, you can do your installation with the previous release and 
bring up Version 5.1 when you reboot the system during your 
installation. You may be running in either time-sharing or 
stand-alone mode. 

Network configuration files are provided on two distribution tapes: 

• DECnet-20 Distribution Tape 

• DN200 Remote Job Entry (RJE) Distribution Tape 

The RJE tape is supplied only if your installation supports remote job 
entry stations. The distribution tapes are DUMPER tapes. The 
contents of these tapes are discussed in Section 1.3.1 and 1.3.2. 

You must create directories on disk for storage of the generation and 
installation files as discussed in Section 1.2. You will need the 
following space allocations: 

For DECnet-20 software: 

3750 pages for working storage 

3750 pages for permanent storage 
For RJE-20 software: 

1750 pages for working storage 

1750 pages for permanent storage 
For RJE dump files: 

1000 pages for working storage 

1000 pages for permanent storage 

Be sure you have enough space before you begin the generation 
procedures . 

You use the following programs to perform the system generation and 

installation: 

• DUMPER, a TOPS-20 file copy utility, which is used to copy 
files from tape to disk. 

• NETGEN, an interactive software generation program, which 
allows you to describe the hardware and software 
characteristics of your DECnet-20 front end (DN20) and, 
optionally, any remote job entry stations (DN200s) . NETGEN 
generates the appropriate .MAC files. 
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• DNMAC, a cross-assembler for PDP-11 macro source files. 

• TKB36, a PDP-11 Task Builder, which builds the files used to 
generate the system. 

• VNP36, a Virtual Network Program, which generates the DN20 or 
DN200 system image. 

• NIPGEN, an interactive network installation program, which 
generates command and control files used to verify your 
generated system and define your node database. 

These programs are collectively known as the DECnet-20 "configuration 
tools." 



1.2 OVERVIEW OF CONFIGURATION PROCEDURES 

To perform a system configuration, you must follow the steps described 
in this manual. These steps are illustrated in the flow charts in 
this chapter. 

If your installation is to support the remote job entry (RJE) 
capability, you must use the RJE generation procedures. The RJE 
procedure generates the RJE software for the DN200. The DN200 is a 
remote station based on a PDP-11/34A connected by a synchronous line 
to a DN20. The DN200 provides an operator's console and may also 
include a line printer, a card reader, or both. The software that 
runs on the DN200 is called RJE-20. 

Note that you must run the DN20 generation procedures before you run 
the RJE generation procedures. 



1.2.1 Overview of Procedure; 



1. Log into TOPS-20 with OPERATOR or WHEEL privileges. 

2. If you are already a DECnet-20 user, verify that <NEW-SYSTEM> 
and <NEW-SUBSYS> are on your system. If they are not, create 
them. Be sure that <NEW-SYSTEM> and <NEW-SUBSYS> are empty 
when you begin, and remember to use <NEW-SYSTEM> for <SYSTEM> 
and <NEW-SUBSYS> for <SUBSYS> where necessary. 

3. Create the following directories on disk: 

• PS:<DN20> for generation files 

• PS:<DxxxxA> for customized files; DxxxxA is a 
user-specified name and you can use any name you like, 
but as a convention, it is recommended that you specify 
the 4-digit serial number of your TOPS-20 KL system, 
preceded by "D" and followed by "A" to specify the DN20 
front end. 
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• PS:<DECNET>, or PS : <NEW-DECNET> if you are upgrading, for 
documentation and source files 

• PS:<DECNET-SOURCES> for source files 

• PS:<DECNET-TOOLS> for DECnet tools 



4. Restore the generation files from the distribution tape to 
the appropriate directories. 

5. Read the Beware file. 



1.2.2 Generating a DN20 Nods 



6. Connect to <DxxxxA>. 

7. Run the interactive NETGEN program to describe the hardware 
and software characteristics of your DN20 node. Note that 
you must rerun NETGEN whenever you change your configuration 

for example, when you add a line. The specifications you 
enter to NETGEN must reflect the hardware at your site. 

8. Check the output from NETGEN, using NETGEN's INFORMATION and 
LIST commands, and change parameters if necessary until the 
node configuration information is correct. When the 
information is correct, give the NETGEN SAVE and FINISH 
commands to create your configuration files. 

9. Use a SUBMIT command with the DN20SYS.CTL file to build the 
DN20 software. This also creates the DN20SYS.LOG file. 

10. Check the log file produced by the batch job for any errors 
in the build process. Correct any errors and rerun NETGEN if 
necessary . 

11. Copy DxxxxA.SYS to <SUBSYS>, or, if upgrading, <NEW-SUBSYS> . 
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1.2.3 Generating DN200 Nodes: 

12. To support RJE stations, create directories: 

• PS:<DN200>, or PS : <NEW-DN200> if upgrading 

• a directory for each RJE station named <DN200A>, 
<DN200B>, and so on. (You can use any name you like; 
<DN200x> is only suggested.) 

• a directory called <nodename-DUMPS> to receive dump files 
from each RJE station. 

• a directory called PS : <DN200-SOURCES> for source files. 

13. Restore files from tape. 

14. Connect to <DN200x>. 

15. Run NETGEN. Note that the DN200 supports 1 DMRll or 1 DMCll 
only. 

16. Check its output. When your configuration information is 
correct, give the NETGEN FINISH command to create your 
configuration files. 

17. Submit the DN200SYS.CTL file to build the RJE software. 

18. Check the log file, correct any errors and rerun NETGEN if 
necessary. You must repeat the RJE generation for each 
station your system supports. 

19. Copy any DN200x.SYS files to <SUBSYS>, or <NEW-SUBSYS> , if 
upgrading . 
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Figure 1-1 General Outline of Configuration Procedures (Cont.) 
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1.2.4 Running NIPGEN: 



20. Run the interactive NIPGEN program (described in Chapter 4) 
to create the command and control files used to verify and 
load your generated system. 



1.2.5 Loading and Verifying Nodes: 

21. Copy the command files created by NIPGEN from your connected 
directory to <SYSTEM>, or, if upgrading, to <NEW-SYSTEM> . 

22. Edit certain system files: SYSJOB.RUN (RJE only) 

SYSTEM. CMD (RJE only) 
5-1-CONFIG.CMD 

23. Set up your PTYCON.ATO file from the distributed NETWRK.ATO 
file. 

24. Use the latest version of OPR, NET, FAL, and (for RJE 
stations) NURD. 

25. Shutdown and reboot the KL. 

26. If TOPS-20 5.1 and the network come up correctly, submit the 
batch file NIPLCL from NIPGEN to check out the host and the 
DN20. If the monitor does not come up, revert back to 
TOPS-20 5.0 and examine your procedures to find the error. 

27. If the network does not come up, try to start it manually. 

• Use OPR's TAKE command to take SYSTEM:NCP to define the 
network nodes. 

• Load the DN20 node with the NCR LOAD NODE command. 

• If the DN20 comes up manually, test the host and DN20 
network capabilities by submitting the NIPLCL control 
file generated by NIPGEN. 

• Check the log file and correct any errors before 
proceeding. 

28. Load any DN200 nodes and verify that they are connected to 
the network and are working properly. 

29. Test the network between the KL host processor, the DN20, and 
the Phase III nodes adjacent to the DN20. 

• Submit the NIPNM control file from NIPGEN. 

• Check the log file and correct any errors before 
oroceedinq . 
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30. Test network integrity between the KL processor and nodes 
that support Network File Transfer/File Access Listener 
(NFT/FAL) . 

• Submit the NIPNFT control file. 

• Check the log file and correct any errors before 
proceeding . 



31. Set up the complete network node database and make it known 
to Network Management through OPR. 

32. When you are satisfied with TOPS-20 Version 5.1 and DECnet-20 
Version 3.0, use the standard TOPS-20 method of making the 
new release the primary software. (See the TOPS-20 Software 
Installation Guide . ) 

If you have cleared up all the errors found during the 
configuration procedure, DECnet-20 Version 3.0 will be fully 
installed at the end of these steps. 
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Figure 1-2 Installing DECnet-20 V3.0 (Cont.) 
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1.3 DISTRIBUTION TAPES 

There are two distribution tapes. These contain a total of 
approximately 120 generation and installation files. The tapes are: 

• DECnet-20 Distribution Tape, which contains all files needed 
to build DECnet-20 V3.0 for any configuration. 

• DN200 Remote Job Entry (RJE) Distribution Tape, an optional 
purchase which contains all files needed to build RJE-20, 
V2.0, the remote job entry capability for any configuration. 

These tapes contain the same information for all systems with the same 
unbundled options. If you have purchased the RJE option, remember 
that the DN20 tape must be used to set up your system for use of the 
task-to-task capability before you use the RJE tape. All tapes are 
DUMPER-formatted and may be copied to disk with the DUMPER utility. 



1.3.1 DECnet-20 Distribution Tape 

The DECnet-20 tape contains the following savesets: 

• <DECNET> containing documentation files 

• <SUBSYS> containing binary files 

• <DN20> containing generation files 

• <DECNET-SOURCES> containing source files 

• <TOOLS> containing decnet tools 
The documentation includes: 

• .BWR (beware), .HLP (help) and .DOC (documentation) files 
associated with DECnet-20 

The binary files include: 

• Files needed to support the task-to-task, file transfer, and 
network command terminal capabilities for your configuration. 

• Files needed to generate your front-end code, and to create 
control files to check out your installation. 

• DNMAC.EXE, a cross-assembler for PDP-11 macro source files. 

• NETGEN.EXE, a program that allows you to enter parameters for 
your site and to construct the configuration files NETPAR.MAC 
and CETAB.MAC, the system parameters and data base for the 
node you are configuring, and NMLACC.MAC, which defines 
access information that remote sites must furnish before they 
can issue certain commands to local DECnet-20 Network 
Management. 

• NIPGEN.EXE, a program that enables you to generate files for 
verifying and loading your system. 

• TKB36.EXE, a program that constructs PDP-11 formatted task 
images from object files. 
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• VNP36.EXE, a program that creates the front-end system image. 
The generation files include: 

• PDP-11 files for all modules needed for any configuration of 
the DN20; this includes task files, symbol tables, and 
memory maps. 

• DN20SYS.CTL, a control file for building a DN20 front end for 
DECnet-2n systems. When the commands in this file have been 
executed, your front-end directory will contain the necessary 
.STB, .MAP, .TSK, .SYS, and MCBMAP.TXT files for the DN20. 

The source files contain source and control files needed to build 
NFT.EXE, FAL.EXE, and NCPTAB.REL. The tools contain unsupported 
programs that may be useful. 



1.3.2 DN200 Remote Job Entry (RJE) Distribution Tape 

The RJE tape contains the following files: 

• PDP-11 files for all modules needed for any configuration of 
the DN2nO; this includes task files, symbol tables, and 
memory maps. 

• DN200SYS.CTL: a control file for building a DN200 front end 
for RJE systems. 

When the commands in this file have been executed, your 
front-end directory will contain the necessary 
.STB, .MAP, .TSK, .SYS, and MCBMAP.TXT files for the DN200. 



1.4 PREPARING TO CONFIGURE 

If you prepare carefully before performing the configuration procedure 
described in this manual, these procedures will run more smoothly. 
Observe the guidelines summarized below before you begin to configure 
your system: 

1. Read this entire manual. Configuring the DECnet-20 
communications front end requires an understanding of 
parameters with which you may not be familiar. Terms used in 
NETGEN and NIPGEN may also have a meaning which is specific 
to the programs. This manual provides an introduction to 
both hardware and software terms, a step-by-step summary of 
the procedures used to generate, verify, and load the system, 
a flowchart, examples of configuration operations, and a 
glossary of terms. 



1-13 



INTRODUCTION 



2. Ensure that the hardware parameters accepted as defaults or 
entered by you when running NETGEN reflect the actual 
hardware installed at your site. 

Also ensure that software parameters are within the ranges 
described in this manual. You may rhooRP to accept the 
defaults supplied by NETGEN for software parameters; this is 
a safe procedure, but one which may not result in optimal 
performance, particularly if you have high network usage and 
the maximum number of lines. 

Do not enter a value other than the default without 
understanding the tradeoffs involved in each specification. 

3. Collect the information you will need during your 
configuration of nodes. Use the Installation Worksheet 
provided on the next page as a guide to the information you 
must have before you begin. Some of this information may be 
available only from field service. 

4. Ensure that you are familiar with the OPR-ORION facilities 
under GALAXY (See T0PS-2n Operator ' s Command Language 
Reference Manual ) . You can successfully complete procedures 
by following system directions. However, you will be better 
prepared to handle unexpected situations if you are familiar 
with the OPR-ORION facilities. 

5. Review the capabilities provided by the DUMPER program and 
the batch system, if you are not familiar with these 
programs. Both DUMPER and the batch system are used during 
this installation. Refer to the TOPS-20 Operator' s Guide for 
information on DUMPER and batch processes. 

6. Secure a termtinal and location where you will not be 
interrupted during the on-site configuration, and set aside 
at least two hours for the configuration procedure. 
Depending upon your own rate of progress, the characteristics 
of your configuration, and the response time of the 
timesharing system being used, the actual time may be less or 
more than this period. Most of the steps in this procedure 
can be done with a system under normal timesharing. However, 
to activate any edits to PTYCON.ATO and 5-1-CONFIG. CMD, you 
must shut the system down temporarily and bring it up again. 
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1.4.1 DECnet-20 Installation Worksheet 



You must know your 

installation. The 

communications device is shown in Table 1-1 



hardware configuration to perform this 
m.aximum number of each type of supported 

For more information, 



see the DECnet-20 V3.0 SPD (Software Product Description). 



Table 1-1 
Supported Devices 



Hardware 



DN20 



Device 


Up to 


DMClls 




2 
4 


at lOnOkb 
up to 56kb 


DMRlls 




2 
4 


above 56kb 
up to 56kb 


KDPs 




2 




DUPlls for 


each KDP 


4 





DTE20 number (DTE-0-1, -2, or - 


-3): 


Cost: 






Number of DMClls (0 to 5) 






DMC-0 Duplex (full, half) 




Cost: 


DMC-1 Duplex (full, half) 


Cost: 


DMC-2 Duplex (full, half) 


Cost: 


DMC-3 Duplex (full, half) 


Cost: 


DMC-4 Duplex (full, half) 


Cost: 


Number of DMRlls (0 to 5) 






DMR-0 Duplex (full, half) 




Cost: 


DMR-1 Duplex (full, half) 


Cost: 


DMR-2 Duplex (full, half) 


Cost: 


DMR-3 Duplex (full, half) 


Cost: 


DMR-4 Duplex (full, half) 


Cost: 


Number of KDPs (0 to 2) 






KDP-0: Number of DUPlls (0 to 


3) 


KDP-0-0 Maximum Baud Ral 
KDP-0-1 Maximum Baud Ra1 
KDP-0-2 Maximum Baud Ral 
KDP-0-3 Maximum Baud Ra1 
KDP-1: Number of DUPlls 
KDP-1-0 Maximum Baud Ra1 
KDP-1-1 Maximum Baud Ral 
KDP-1-2 Maximum Baud Ral 
KDP-1-3 Maximum Baud Ral 


:e: 


Cost: 


:e: 


Cost: 


te: 


Cost: 


:e: 


Cost: 


(0 to 
:e: 


3) 


Cost: 


:e: 


Cost: 


:e: 


Cost: 


:e: 


Cost: 



DN200: 



Card Reader (yes or no) 
Line Printer (yes or no) 
DMCll or DMRll: 
Cost: 
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NOTE 

In your DN20, hardware addresses for 
DMClls must precede hardware addresses 
for DMRlls to be compatible with 
DECnet-2 NETGEN. If your DN2 contains 
both types of devices, and you are not 
sure if this addressing rule has been 
followed, consult your Field Service 
representative . 



Software: 



Tapes: DECnet-20 
RJE-20 
TOPS-20 5.1 Monitor 

Disk Space Needed: 

For DECnet-20 Software: 3750 pages 
For RJE-20 Software: 1750 pages 
For RJE-20 Dumps: 1000 pages 

DN2 Node: 



Name : 



Address (1 to 255): 

Buffer Size (290 to 576): 

Identification (1 to 32 characters) 
Inactivity Timer (1 to 65535 seconds) 

Management Account: 

Management Password: 

Management User: 

Maximum Address (2 to 255): 

Maximum Cost (1 to 1022): 

Maximum Hops: (1 to 30) 



Maximum Visits (16 to 255) 

Maximum Links (3 to 16): 

Maximum Phase-II Links (0 to 40) : 
Outgoing Timer (1 to 65535 seconds) 
Routing Timer (1 to 65535) 



Initial Settings 

None 

None 

576 

DECnet-20 V3 . Release 

30 

None 

None 

None 

255 

100 

16 

32 

8 

20 

30 

60 



Phase-II Transmit Password (1 to 8 characters) DECNET20 
Retransmit Factor (1 to 15) 5 



DN200 Nodes; 



Name: 

Address (1 to 
255) : 
Host User Name; 

Host Account: 
DN20 Data Link; 



-DUMPS 
'-DUMPS 



-DUMPS 
"-DUMPS 
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1.4.2 Network Nodes for NIPGEN 



Host Node Address 

Name: 

User Name: 

Account: 

Password : 

Host Data Link: 



Remote Node Address 

Name : 

Phase III (y ,n) : 

File Xf er (FAL) (y ,n) : 

User Name: 

Account: 

Password : 



DN20 Node Address: 
Name : 

DN200A Node Address; 

Name : 

DN20 Data Link: 



Remote Node Address; 

Name: 

Phase III (y ,n) : 

File Xfer (FAL) (y,n) ; 

User Name: 

Account: 

Password : 



DN200B Node Address; 

Name: 

DN20 Data Link: 

DN200C Node Address; 

Name : 

DN20 Data Link: 

DN200D Node Address; 

Name: 

DN20 Data Link: 

Remote Node Address; 

Name: 

Phase III (y ,n) : 

File Xfer (FAL) (y ,n) ; 

User Name: 

Account: 

Password : 

Remote Node Address; 

Name: 

Phase III (y ,n) : 

File Xfer (FAL) (y,n) ; 

User Name: 

Account: 

Password: 



Remote Node Address; 

Name: 

Phase III (y fn) : 

File Xfer (FAL) (y ,n) ; 

User Name: 

Account: 

Password: 

Remote Node Address; 

Name: 

Phase III (y ,n) : 

File Xfer (FAL) (y,n) ; 

User Name: 

Account: 

Password: 
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NETGEN OVERVIEW 



This chapter describes the hardware and software terms that are used 
in performing network configuration procedures. You may not be 
familiar with some of the terms or with the specific meaning which 
these terms have for NETGEN or the other DECnet-20 configuration 
tools. 

The NETGEN (NETwork GENeration) program enables you to describe the 
hardware and software characteristics of your DN20 and DN200 nodes by 
specifying values for a variety of hardware/software parameters. 
NETGEN supplies defaults for all of these parameters. You may accept 
the defaults for many of these parameters or may specify new values 
that are more appropriate for your own configuration. You may specify 
a parameter by issuing NETGEN commands and responding to prompts. 

The NETGEN LIST command may be issued at any time to display the 
values currently in effect for all of your configuration's hardware 
and software parameters. 



2 . 1 PARAMETERS 

This section summarizes the parameters you enter when running NETGEN. 
Parameters are described in their order as seen with the NETGEN LIST 
EXECUTOR CHARACTERISTICS command. Only parameters you can change with 
NETGEN are listed. Others are not user settable. Hardware is listed 
at the end of this section. 



Parameter 

Node type 



Node name 



Meaning 

Type of node being generated: 
DECnet-20 front end or DN200 
entry (RJE) station. Using the 
implies use of the DTE20 device; 



DN20 for a 

for a remote job 

DN2 node type 

using the DN20n 



node type implies use of the DMC or DMR device. 

Default: DN20 

Name for the node you are generating with NETGEN. 
The name must include at least one alphabetic 
character and cannot exceed six characters. 
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Parameter Meaning 

Node address Number which identifies the address of node being 

generated. This address must be unique within the 
network. Any decimal number in the range 1 
through 255 may be specifipd, provided that it 
does not duplicate an address assigned to another 
node in the network. Generally, you should use 
low numbers for addresses of nodes in a small 
network. You cannot use a node address larger 
than the Maximum Address you specify. If you 
enter an address incompatible with your Maximum 
Address or Buffer Size, NETGEN warns you. 

Identification A string you can use to identify the software you 

are generating. The string can be seen with the 
NCP SHOW EXECUTOR CHARACTERISTICS command. You 
can specify any text string of 1 to 32 characters. 

Default: DECnet-20 

Outgoing Timer The number of seconds to wait for acknowledgement, 

from a remote node, to a connect request issued 
locally. The range is 1. to 65535. seconds. 

Default: 30 

Maximum Links The maximum number of logical links supported by 

DECnet-20. The range is 3 to 16. 

Default: 8 

Inactivity Timer Number of seconds to wait before exercising a 

logical link when there is no received traffic on 
the link. This can happen, for example, because 
the network is disconnected, or because the 
physical line went down. When the timer runs out, 
NSP sends a data request message over the logical 
link. If, after a certain amount of time (see 
Retransmit Factor) there has been no 
acknowledgement of the message, NSP decides that 
the physical network supporting the logical link 
has failed. The range for the inactivity timer is 
1 to 65535 seconds. 

Default: 30 

Retransmit Factor The number of times the node software retransm.its 

a message without receiving acknowledgement before 
the DECnet-20 software running in the node 
determines that the physical link supporting a 
logical link has failed. The range is 1 to 15. 

Default: 5 

Routing Timer Maximum time to elapse before transmitting a 

routing message. The range is 1 to 65535 seconds. 

Default: 60 
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Parameter Meaning 

Maximum Address: Maximum address for a node in the same network as 

the node you are configuring. The specified value 
must be at least equal to the node address of the 
node you are configuring. This parameter 
determines the highest node address in the 
network. The range is 2 to 255. The Maximum 
Address, node Address, and the Buffer Size you use 
must be compatible. NETGEN computes buffer size 
depending on the maximum, address you enter, and 
warns you if they are incompatible. 

Default: 255 

Maximum Cost Highest allowable "cost" associated with a 

particular logical path. This parameter is 
dependent Qn the individual line costs (the costs 
of transferring a message over a line) and path 
costs. The range is 1 to 1022. 

Default: 100 

Maximum Hops The maximum number of hops allowed between any 

pair of nodes in the network. The largest value 
for maximum hops in a network is the network 
"diameter". You cannot set the value of Maximum 
Hops lower than the value of Maximum Visits. The 
range is 1 to 30. 

Default: 16 

Maximum Visits The maximum num.ber of visits to network nodes that 

any message can make. A node that receives a 
message with a visit count greater than the value 
of Maximum Visits set discards the message. The 
Maximum Visits value set must be greater than or 
equal to the Maximum Hops set. The range is 16 to 
255. 

Default: 2 times Maximum Hops: 32 

Buffer Size The size of buffers used to transmit and receive 

data over any physical link in the network. The 
size you specify must be the same on every node in 
the network. A DECnet-20 node cannot com.municate 
with any node whose buffer size differs from its 
own. The smallest buffer size useable in a given 
network depends on the number of nodes in the 
network. The buffer size is (2* Maximum Address) 
+5, but not less than 290. The range is 290 to 
576. 

NETGEN computes the minimum buffer size depending 
on the maximum address you enter. If you enter a 
buffer size that is less than the computed 
minimum, NETGEN warns you. 

Default: 576 
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Parameter 

MaximuiTi Phase-II 
Links 



Meaning 

Maximum number of logical links to be supported 
for communication with adjacent Phase II nodes. 
The number can be to 40. 



Default: 20 



Phase-II Transmit 
Password 



Optional parameter identifying the password sent 
to a remote node during a Phase II initialization 
sequence. The password must be a text string 
consisting of 1 to 8 characters. DECnet-20 does 
not check passwords on received messages, but 
other DECnet implementations may. Set the 
transmit password to match the password expected 
bv other Phase II nodes. 



Management 
Parameters 



KDPs 



Default: DECNET20 

Three parameters you can set to restrict users at 

remote terminals from giving NCP commands at your 

local DN20 node. The parameters are: 

Account Up to 16 characters long. 

User I.D. Up to 16 characters long. 

Password Up to 8 characters long. 



The default for each is a null 
not enter any of these access 
any user at any remote terminal 
access to local Network Managem 
non-null string must be matched 
before the remote user can 
command, other than SHOW, on 
Character strings can be nu 
alphanumeric characters includ 
The account parameter is not ch 
The management parameters are n 
LIST EXEC CHAR unless set by 
also use these parameters when 

Default: null strings 



string. If you do 

control parameters, 

has unrestricted 

ent commands. Each 

by the remote user 
execute any NCP 

your local node. 
11, or contain any 
ing "." and "-". 
ecked by DECnet-20. 
ot displayed with 
the user. You will 
you run NIPGEN. 



Number of KDPs on your DN20 (0 to 2) . A KDP is a 
combination of a KMCll controller and one to four 
DUPll's (the default is two DUPll's). With the 
KMC , the DUPll functions as a direct memory access 
device (DMA) . The interface is synchronous. 

Default: 



DUPlls 



DMClls 



Number of DUPlls on your KDP (0 to 4) . 

Default: 2 (0 if no KDP) 

Number of DMClls on your DN20 (0 to 4). The DMCll 
is a single-line microprocessor-based interface to 
the network. The DMCll is a synchronous DMA 
device. 



Default: 
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Parameter 

DMRlls 



DTE20 number 



Meaning 

Number of DMRlls on your DN20 (0 to 4). The DMRll 
is a single-line microprocessor-based interface to 
the network. The DMRll is a synchronous DMA 
device. 

Default: 

Number of the DTE20 with which the DN20 interfaces 
to the DECSYSTEM-2040S/206n processor. This is 
not the number of DTE20s. 

Normally, the DN20 used for DECnet-20 uses DTE20 
number 1, 2, or 3. You cannot use DTE20 number 
which is always dedicated to the console front 
end . 



Line printer 



Card Reader 



Default: DTE-0-1 

Line printer in your configuration 
parameter only for a DN200. 



Default: 







Card reader in your configuration, 
parameter only for a DN200. 



Default; 







Specify this 



Specify this 



2.2 REPRESENTATIVE CONFIGURATIONS 

The following diagrams illustrate possible configurations that you can 
specify with NETGEN. 




MR-S-2298-82 



Figure 2-1 Configuration of DN20 Nodes ra and n 




MR-S-2299-82 



Figure 2-2 Configuration of DN20 Node n and DN200 Node a 
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2.3 NETGEN COMMANDS 

The NETGEN (NETwork GENeration) program is an interactive program 
which helps you to configure your installation by producing 
configuration files for a DN20 or DN200 DECnet-20 node. You can use 
NETGEN comm.ands to display and/or change the netv/ork node type, 
parameters, and communications equipment. The files produced by 
NETGEN are used in later steps of the network generation procedure. 

NETGEN is the core of the configuration procedure described in this 
manual. Use of this program requires that you be familiar with the 
hardware and software concepts discussed in Chapter 1, and with the 
characteristics of your own configuration. 

NETGEN must be run once without errors to generate the basic DN20 
capability. In addition, if the remote job entry (RJE) (DN200) 
feature is to be generated at your installation, NETGEN must be run 
once for each DN200 in your configuration. You must also repeat these 
configuration procedures whenever you change the local node 
configuration - for example, when you add a line to the configuration. 

NETGEN commands are of two types: 

• NETGEN-only commands such as START and INCLUDE 

• NCP-type commands such as DEFINE and LIST 

NETGEN-only commands apply only to NETGEN and are unique to NETGEN. 
NCP-type commands are designed to contain the same parameters and 
syntax as the NCR com.mands of the same form you can execute through 
OPR. NCP-type commands do not provide the same guideword facilities 
as NETGEN-only commands. 



2.3.1 NETGEN Help and Recognition Features 

NETGEN provides several features that help you to enter necessary 
com.mands and arguments: 

• You may type a question mark in response to the NETGEN prompt 
to display a list of NETGEN commands. 

• You may follow a command name with a question mark to display 
a prompt for the valid arguments. 

• You may follow a com.mand name with an ESCAPE key to display a 
guideword for the argument. 

• You may take advantage of NETGEN's recognition input feature. 



2.3.1.1 Requesting a List of Commands - You may ask NETGEN to display 
a list of valid commands by responding to the NETGEN> prompt with a 
question mark (?). An example is shown below: 



NETGEN> ? one of the following: 
Define Exclude Exit 
Include Information List 
Purge Push Restore 
Take 



Finished Help 
Log Node 
Save Start 
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2.3.1.2 Requesting a List of Arguments and Values - When you specify 
a particular command and are not certain about its valid arguments, 
you may type the command name, followed by a space, followed by a 
question mark. NETGEN responds by displaying the valid arguments for 
the command. For example: 



i 

NETGEN>include (in configuration) ? one of the following: 
Card-Reader DMCll DMRl 1 DTE20 KDP 

Line-Pr inter 
NETGEN>include (in configuration) 

You may also use the question mark to request that NETGEN display the 
values for a particular argument. For example, suppose you wish to 
specify that the controller in your configuration is a KDP. Type KDP, 
press the space bar, and type a question mark. NETGEN responds with a 
prompt for more information about the KDP and the legal range of 
values for your response. After you enter an appropriate response, 
NETGEN will continue to prompt for additional information. An example 
is shown below. 

( ESC ) Q^ 

i T 

NETGEN>include (in configuration) kdp (number) ? KDP number, to 2 

NETGEN>include (in configuration) kdp (number) ? confirm with carriage return 

NETGEN>include (in configuration) kdp (number) ( b£t ) 

Number of DUPll lines on this KDP: 1 (T^ 

KDP-0-0 Maximum Baud Rate: ? one of the following: 

1200 1800 19200 2400 3600 4800 7200 9600 
KDP-0-0 Maximum Baud Rate: 2400 ("TiT) 
KDP-0-0 Cost: 2 QeT) 
NETGEN> 



If you type ? at the end of a command, when no further response is 
expected, NETGEN displays the message shown below. 

NETGEN>include kdp (number) ? confirm with carriage return 
NETGEN>include kdp 

Respond by pressing the RETURN key. 



2.3.1.3 Requesting a Guideword for the Argument - If you follow KDP 
by pressing the ESCAPE key ( ( esc ) ) instead of a question mark, NETGEN 
displays a guideword indicating the type of response (for example, 
"number") that is required. An example is shown below. 

( ESC ) 
\ 

NETGEN>include kdp (number) 

If you type C esc ) at the end of a command, that is, when no further 
response is expected or if no guideword is provided, NETGEN ignores 
the ( r~Esr) character. However, for the INCLUDE and EXCLUDE commands, 
NETGEN supplies defaults. 
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2.3.1.4 Using Recognition - The TOPS-20 recognition feature is 
provided for NETGEN and operates according to standard T0PS-2n 
conventions. The recognition feature allows you to use the ESCAPE key 
to complete commands. Because you may not be familiar with the NETGEN 
commands, recognition is likely to be very helpful when you use 
NETGEN. 

An example of recognition is included below. In this example, the 

same instructions require more than twice as many key strokes for full 

input as for recognition input. Notice how the guidewords in this 
example lead you to enter the correct response. 

Full input: 

NETGEN>save PS : <FORSYTHE>CONFIG. CNF C^^ 
Using recognition: 

CiD 
I 

NETGEN>SAve (configuration on) PS : <FORSYTKE>CONFIG. CNF ChD 



2.3.2 NETGEN Error Messages 

NETGEN provides error m.essages both for syntax errors and for assembly 
errors. NETGEN error messages are described in Appendix A, "Error 
Messages." If you enter an incorrect command or argument, NETGEN 
displays an appropriate message. For example, the following shows an 
invalid comm.and: 

NETGEN>pop ( RET ) 

? Does not match switch or keyword 

NETGEN> 

The following shows another common error message: 

NETGEN>node address ABC 

? First nonspace character is not a digit 

NETGEN> 

In this example, NETGEN expected but did not receive a numeric value. 
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2.3.3 NETGEN Reconfiguration Facilities 

NETGEN provides a RESTORE facility to simplify reconfiguration of a 
network node. When you use this facility, you must have a .CNF file 
containing your front-end configuration created earlier. You then 
RESTORE the .CNF file, make the changes you need to the configuration 
with INCLUDE or DEFINE commands, SAVE'the edited file and use the 
FINISH command to generate all the other NETGEN output files. Use 
INCLUDE to change your hardv;are configuration, DEFINE to change any 
software specifications. 

You can find an example of using the RESTORE/SAVE/FINISH commands in 
Chapter 3, "Installation." 



2.4 NETGEN COMMAND SYNTAX 

The syntax for the individual NETGEN commands is described on the next 
few pages. 
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CCBS 



2.4.1 DEFINE EXECUTOR: Defining Executor Characteristics 

Description: 

Defines the characteristics of your executor noile. The 
management arguments restrict users at remote locations from. 
giving NCP comm.ands at your local node. All numeric values to 
the arguments are decimal. 

Arguments: 

Address: numeric value, 1 to 255 

Buffer Size: num.eric value, 290 to 576 

Identification: text, 1 to 32 characters 

Inactivity Timer: numeric value, 1 to 65535 seconds 

Management Account: string, to 16 characters, "." and "-" 

Management Password: string, to 8 characters, "." and "-" 

Management User-Id: string, to 16 characters, "." and "-" 

Maximum Address: numeric value, 1 to 255 

Maximum Cost: numeric value, 1 to 1022 

Maximum Hops: numeric value, 1 to 30 

Maximum Links: num.eric value, 3 to 16 

Maximum Phase-II Links: numeric value, to 40 

Maximum Visits: numeric value, 1 to 255 

Name: node name, 1 to 6 characters 

Outgoing timer: numeric value, 1 to 65535 seconds 

Phase-II Transmit Password: text, 1 to 8 characters 

Retransmit Factor: numeric value, 1 to 15 

Routing Timer: numeric value, 1 to 65535 seconds 

Example: 

NETGEN>def exec add 1 CeD 
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EXCLUDE 



2.4.2 EXCLUDE: Removing a Device 

Descr ipt ion : 

Removes a device from the configuration. 

In certain cases, default is provided for the EXCLUDE command. 
If you type: 

CeED 

\ 

exclude dmrll (number) ( esc ) 



NETGEN will automatically fill in the most recently included 
device number. This applies to the following: 

exclude kdp 
exclude dmcll 
exclude dmrll 



Arguments: 



Card-Reader 

DMCll: number of DMCll, to 5 

DMRll: number of DMRll, to 5 

DTE20: number, 1 to 3 

KDP: number, to 2 

Line-Pr inter 



Example 



i 

NETGEN>exclude (from configuration) ? one of the following: 

Card-Reader DMCll DMRll DTE20 KDP 

Line-printer 

( ESC ) 

NETGEN>exclude (from configuration) KDP (number) CID C^D 
NETGEN> 
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EXIT 



2.4.3 EXIT: Exiting from NETGEN 

Description: 

Exits from NETGEw procedure. Saves no files. To save your 
configuration files, use SAVE and FINISH before typing EXIT. 

Argument : 

None 
Example: 

NETGEN>exit (J^D (from NETGEN) QiT) 
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FINISHED 



2.4.4 FINISHED: Finishing the Configuration 

Description: 

Indicates that you have finished with the configuration. When 
you give this command, NETGEN writes its output files, 
NMLACC'.MAC, CETAB.MAC and NETPAR.MAC, to your connected 
directory. If you have generated a system that is not a 
supported configuration, NETGEN warns you. 

Argum.ent : 

None 

Example: 

I 

NETGEN) finished (with configuration) C^ir^ 
[Generating PS : <DxxxxA>NMLACC .MAC. 1 2] [OK] 
[Generating PS : <DxxxxA>CETAB .MAC . 12] [OK] 
[Generating PS : <DxxxxA>NETPAR. MAC . 12] [OK] 

NETGEN> 
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HELP 



2.4.5 HELP: Displaying a NETGEN Description 

Descr ipt ion : 



it the user terminal a short description of the function 
of NETGEN. The "(with NETGEN)" phrase is displayed if you use 



the TOPS-20 recognition feature ( esc ) . 
Argument : 
None 

Example : 

1 

NETGEN>help (with NETGEN) (JeD 

NETGEN-20 is the tool that produces configuration files for a 
DN20 or DN200 DECnet-20 node. Using its comm.ands, you can 
display and/or change network node type, parameters and 
communications configuration. NETGEN allows recognition (use of 
ESC key) and help text (use of ? key) to aid your selection of 
legal options. 

Typically, you will use NETGEN to: 

-select node type: DN20 (task-to-task node) - (default) 
or DN200 (remote job entry station) 

-include synchronous communication line(s) 

-optionally, change parameter settings to tailor your 
configuration to suit local needs 

-write the configuration files CETAB.MAC and NETPAR.MAC, 
which will be used by later steps in the Network 
Installation Procedure. 
NETGEN> 



2-14 



NETGEN OVERVIEW 
INCLUDE 

2.4.6 INCLUDE: Adding a Device 

Description: 

Adds a device to the configuration. 

In certain cases, an automatic default is provided for the 
INCLUDE command. If you type: 

include kdp Q^D (number) fliP ) 

NETGEN will provide as a default or the next available number. 
This applies to the following: 

include kdp 
include dmcll 
include dmrll 
include dte20 

Note that INCLUDE DTE20 GiD always defaults to 1 if the node 
type is DN20. There is no default DTE number for DN20ns. 

If you include a KDP, NETGEN prompts you to specify the number of 
lines on the KDP and the maximum, baud rate and cost for each. If 
you include a DMCll or DMRll, NETGEN prompts you for transmission 
mode (full or half duplex) and cost for each. 

Arguments: 

Card-Peader (1 for a DN200) 

DMCll: number of DMCll, to 5; duplex, full or half; cost, 

1 to 25 
DMRll: number of DMRll, n to 5; duplex, full or half; cost, 

1 to 25 
DTE20: number, 1 to 3; cost, 1 to 25 
KDP: num.ber, to 2; maximum baud rate, 1200 to 19200; cost, 

1 to 25 
Line-Printer (1 for a DN200) 

Example : 



\ 

NETGEN> include (in configuration) -? one of the following: 

Card-reader DMCll DMRll' DTE20 KDP 

Line-pr inter 

NETGEN>include (in configuration) i<(3p ( fliT) (number) 7 KDP Number, to 2 

NETGEN>include (in configuration) kdp (number) q 7 confirm with carriage return 

NETGEN>include (in configuration) kdp (number) QiT) 

Number of DUPll lines on this KDP: 1 qjt") 

KDP-0-0 Maximum Baud Pate: ? one of the following : 

1200 1800 19200 2400 3600 4800 7200 9600 
KDP-0-0 Maximum Baud Rate: 2400 CTFT) 
KDP-0-0 Cost: ? Cost of this circuTt, 1 to 25 
KDP-0-0 Cost: 1 QiT) 

NETGEN> include (in configuration) DMCll (number) g (^[£) 
DMC-0 Duplex: ? one of the following: 

Full Half 
DMC-0 Duplex: full CTTT) 

DMC-0 Cost: ? Cost of this circuit, 1 to 25 
DMC-0 Cost: 2 (UT) 
NETGEN> 
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2.4.7 INFORMATION: Displaying Node Information 

Description : 



Arguments : 

Card-Reader 
Line-Pr inter 
Node 
Node-Type 



, 4- ^ I.U -. i~ U 



. o una 



lavc kjccii aci 



Example 



( ESC ; ( ESC } 

I I 

NETGEN>iNFOrmation (about) Node ? confirm with carriage return 

NETGEN>INFOrmation (about) Node f^iT) 



Node name is: 
Node address is 
Node type is: 
Line printers: 
CRlls: 
NETGEN> 



KKLLMM 

2 

DN20 (default; 

(default) 

(default) 
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2,4.8 LIST: Displaying Characteristics 

Descr lot ion : 



Displays the characteristics you have set for your executor or 
your known circuits. The management parameters do not appear if 
you have not set them. 

Arguments; 

Executor characteristics 
Known Circuits characteristics 
Known Lines characteristics 

Examples: 

NETGEN>List executor characteristics ( ret ) 

Executor Node = 2 (KKKLLL) 

Identification = hhh 

Management Version = 3.0.0 

Loop Count = 1 

Loop Length = 127 

Loop With = Mixed 

Incoming Timer = 10 

Outgoing Timer = 30 

NSP Version = 3.2.0 

Maxim.um Links = 8 

Delay Factor = 2 

Delay Weight = 3 

Inactivity Tim.er = 30 

Retransmit Factor = 5 

Routing Version = 1.3.0 

Type = Routing 

Routing Timer = 60 

Maximum Address = 255 

Maximum Circuits = 1 

Maximum Cost = 100 

Maximum Hops = 16 

Maximum Visits = 32 

Buffer Size = 5'76 

Maxim.um Phase II Links = 20 

Phase II Transmit Password = DECNET20 

Management User = klh 

Management Account = 341 

Managem.ent Password = (password set) 

NETGEN>list known circuits characteristics QeT) 

Circuit = DTE-0-1 

Cost = 1 

Hello timer = 10 

Listen timer = 60 

Owner = Node / 2 / KKKLLL 

Line = DTE-0-1 
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Circuit = DMR-0 

Cost = 1 

Hello Timer = 10 

Listen timer = 60 

Owner = NODE / 2 / KKKLLL 

Line = DMR-0 

Type = DDCMP-DMC 

NETGEN>lis': Known lines characteristics (JED 
Line = DTE-0-1 

Device = DTE-0-1 
Controller Register = 174440 
Interrupt Vector = 770 
Interrupt Priority = 7 
Pause Timer = 30 

Line = DMR-0 

Device = DMR-0 
Receive Buffers = 10 
Controller = Normal 
Duplex = Half 
Protocol = DDCMP-DMC 
Clock = External 
Service Timer = 3000 
Retransmit Timer = 3000 
Controller Register = 160740 
Interrupt Vector = 670 
Interrupt Priority = 5 

Line = KDP-0-0 

Device = KDP-0-0 
Controller = Normal 
Duplex = Full 
Protocol = DDCMP-DMC 
Clock = External 
Service Timer = 3000 
Retransmit Timer = 3000 
Controller Register = 160540 
Unit Register = 160300 
Interrupt Vector = 540 
Interrupt Priority = 5 
Baud Rate = 2400 
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2.4.9 LOG: Logging NETGEN Commands 

Description: 

Logs all of your NETGEN commands in a disk file. If you make a 
mistake in your NETGEN procedure, you can TAKE this log file 
instead of reentering all of the commands. 

Argument: 

output filespec 

Example: 

i 

NETGEN> log (TTY input to file) ? name of output file to record TTY input 
NETGEN>log {TTY input to file) marl. LOG CiT) 

NETGEN> 
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2.4,10 NODE: Specifying the Node Type 

Descr iption : 

.qppn i f -j p.q the node type for the node bcinQ c< 
Argument : 

Type DN20 or DN200 
Example: 

( ESC ) 

I 
t 

NETGEN>node type (is) ? one of the following 

DN20 DN200 
NETGEN>node type (is) dn20 C^ 
NETGEN> 
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2,4,11 PURGE EXECUTOR: Removing a Parameter 

Descr iption: 

Removes a parameter you have previously set for your executor 

Arguments: 

Identification 

Management Account 

Management Password 

Management User 

Outgoing Timer 

Phase-II Transmit Password 



Example: 



NETGEN> purge executor outgoing timer ( ret ) 
NETGEN> 
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2.4.12 PUSH: Entering the TOPS-20 Executive 

Descr ipt ion : 

Transfers you from NETGEN command level to the TOP5-2n ComiTiand 
Processor (EXEC). While at this level, you can issue any 
necessary TOPS-20 commands. The NETGEN commends that you have 
entered are not lost. You can return to NETGEN by giving the 
TOPS-20 command, POP. 

Argument : 

None 
Exam^ple : 

NETGEN>push QiD 
TOPS-20 Command processor 5(711) 

@P0P ( RET ) 

NETGEN> 
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2.4.13 RESTORE: Restoring a Saved Configuration 

Descr ipt ion : 

Restores the file saved from a file on disk. You may override 
the default by specifying a different directory or file name. 
For example, the command: 

RESTORE PS:<SMITH> fliQ 

Restores the configuration from the previous .CNF file you have 
used. When you use the RESTORE command, cum>ulative updates are 
done in order . 

Argument : 

input filespec 

Example : 



\ 

NETGEN> restore (configuration from) ? input filespec 
NETGEN>r estore (configuration from) marl.cnf ( ret ) 
[Configuration Restored From: PS : <D2110A>MARL. CNF . 1 
NETGEN> 
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2.4.14 SAVE: Saving a Configuration 

Descr iption : 

Sdves the cuiLsriL pdidirieteL seLLinyS in 3 file ori disk 
Argument : 

output filespec 
Example : 

( ESC ) 

I 

NETGEN>save (configuration on) ? output f ile spec 
NETGEN>save (configuration on) marl.cnf ( ret ) 
[Configuration Saved On: PS : <D2110A>MARL. CNF . 1 ] 
NETGEN> 
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2=4,15 START: Entering NETGEN Dialog 

Descr ipt ion : 

Engages the user in an interactive dialog with which he/she gives 
node configuration specifications. NETGEN gives warning and 
fatal error messages as necessary, and, if there are no fatal 
error messages, writes output files to the user's connected 
directory. The user may need to give additional configuration 
commands and end the task with SAVE and FINISH commands. NETGEN 
provides defaults for some parameters when you use the START 
dialog. View the defaults with the ( esc ) key. 

Argument : 

None 

Example: 

NETGEN r^JD 

T0PS-2n Network Configurator for DN20 or DN200, Version 3(56) 

[Type START to begin configuration dialog] 

(IE) 
\ 

NETGEN>start (dialog for performing configuration) ( R" ) 
Node type: dn200 C^^ 
Node name: new2 C ret ) 
Node address: 20 C ret ) 

Do you have a card reader on this DN200? n ( ret ) 

Do you have a line printer on this DN200? y ( ret ) 

What is the communications line interf ace on the DN200? 
Specify either DMCll or DMRll: dmcll ( ret ) 

[Configuration Saved On: PS : <DN200A>NEW2 . CNF . 1] 
[Generating PS : <DN200A>NMLACC .MAC . 1] [OKI 
[Generating PS : <DN200A>CETAB .MAC . 1] [OK] 
[Generating PS : <DN200A>NETPAR.MAC . 1 ] [OK] 

[Configuration Complete] 

Type SAVE and FINISH after any additional changes 
Type EXIT to terminate NETGEN 

NETGEN> 
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2.4.16 TAKE: Taking a File 

Descr iption : 

Tells NETGEN to read coTnmanrls from the sppcifipd disk filp r^thpi 
than expecting these commands to be entered from the terminal. 

Argument : 

input filespec 

Exam.ple : 

NETGEN>take (commands from) ? input filespec 
NETGEN>take (com.m.ands from) marl.ciT.d QeT) 

NETGEN> 
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This chapter describes how you use NETGEN to prepare configuration 
software that will run in your communications .processor . Each section 
in this chapter describes the configuration process for a separate 
product. The products described in this chapter are: 

• DECnet-20 for a DN20 

• DECnet-20 for a DN200 



3.1 DN20 CONFIGURATION 

This chapter describes the procedures that you must follow to 
configure the DN20 capability on any DECSYSTEM-2n40S/2 060 . This is 
the first step in generating and installing DECnet-20<. Steps in the 
procedures described in this and subsequent sections are numbered 
sequentially throughout. 

To perform an on-site configuration, you must have available the 
Version 5.1 monitor of the TOPS-20 operating system. You can either 
install Version 5.1 first and have it running as you do your on-site 
configuration, or, if you are upgrading from a previous TOPS-20 or 
TOPS-20/DECnet-20 release, you can do your configuration with the 
previous release and bring up Version 5.1 when you reboot the system. 

Because command files, control files, and logical definitions may 
refer to certain files, you should ordinarily name and locate these 
files as shown in the descriptions and examples shown below. If your 
installation's conventions allow it, file names and locations may be 
changed after the configuration and installation procedures have been 
successfully completed. You should be aware, however, that should you 
subsequently wish to reconfigure the system or to run validation or 
certification tests for diagnostic purposes, you will have to resolve 
references to files and data structures. 

The parameters that appear in the commands below have the following 
character istics: 

• All parameters have been chosen to ensure that the procedure 
runs efficiently. 

• Specified space parameters allow for expansion. 

• Specified actual and logical names permit inter-directory 
referencing . 
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3.1.1 Initial System Setup 

i^ STEP 1: LOGIN and ENABLE WHEEL or OPERATOR PRIVILEGES 

If you are a new customer, you must bring up your TOPS-20 Version 5.1 
monitor bpforp yon can pprform t-hi.=; ,qi-ep. Have your system files on 
PS:<SYSTEM> and PS:<SUBSYS>. 

i^STEP 2: IF UPGRADING, USE <NEW-SYSTEM> , <NEW-SUBSYS> 

If you are upgrading from a previous version of DECnet-20, use the 
<NEW-SYSTEM> directory in place of <SYSTEM>, and the <NEW-SUBSYS> 
directory in place of <SUBSYS>. You may need to create these 
directories if they do not exist in your system. If you have 
previously used these <NEW- directories, copy any files you need to 
keep from them into some other directories, to empty the 
<NEW- directories for your use. If you have an earlier version of 
T0PS-2n running, use it until you bring up the new monitor later in 
this procedure. 

Before you bring up TOPS-20 V5.1, define your system-wide logical 
names in 5-1-CONFIG. CMD as follows: 

SYS: as PS : <NEW-SUBSYS> , PS:<SUBSYS> 
SYSTEM: as PS : <NEW-SYSTEM> , PS : <SYSTEM> 

Be sure to keep your previous system.s (TOPS-20 and DECnet) in the old 
directories until you are satisfied with all of the new release. 

^STEP 3: TYPE DIR PS : <DECNET> GE) 

Determine if the PS:<DECNET> directory is on your system. If not, you 
must create it. IF it is on your system because you are upgrading 
from a previous version of DECnet-20, create the directory 
PS : <NEW-DECNET> for the new files you will restore from tape. 

$DIP PS:<DECNET> C^^ 

PS:<DECNET> 
NET. MAP. 2 

Total of 1 file 

INSTEP 4: CREATE THE PS : <DECNET> OR PS : <NEW-DECNET> DIRECTORY 

If PS:<DECNET> does not exist on your system, create it. If 
upgrading, create PS : <NEW-DECNET> instead. The example below shows 
how to create PS;<DECNET>, T^ater in the generation procedure, you 
will copy the documentation files from the distribution tape to this 
directory. This will be your documentation directory. 



Type 



$"ECREATE PS:<DECNET> QeD 

[New] 

$$WOPKING 2000 ChD 

$$PERMANENT 2000 CED 

$$PP-OTECTIOM 7777^0 f ret ^ 

$$FILES-ONLY CeD 

$S CED 
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3.1.2 Generating Front-End Software 

i^ STEP 5: CREATE THE PS:<DN20> DIRECTORY 

The DN20 configuration files are located on the DECnet-20 distribution 
tape in the directory PS:<DN20>. Create a directory on disk named 
PS:<DN20>. Later in the generation procedure, you will copy the 
generation files on the distribution tape to this disk directory. 
This is your DECnet system directory. 



Type 



$"ECREATE PS:<DN20> CUD 

[Newl 

$$WORKING 100 diD 

$$PERMANENT 1000 QeT) 

$$PPOTECTION 777740 QiT) 

$$FILES-ONLY Q^D 

$$MAXIMUM 1 r^JT^ 

$S 



$ 
STEP 6: CREATE THE PS : <DxxxxA> DIRECTORY 

Create a separate front-end directory on disk. This directory will 
contain only those files that are specific to the front-end software 
you are generating. 

You may give this directory any name you wish. For purposes of 
standard naming conventions, however, it is recommended that you use 
the format PS:<DxxxxA>, where xxxx in the directory name corresponds 
to the 4-digit serial number of your TOPS-20 KL system. 



Type : 



$^ECREATE PS:<DxxxxA> C^^ 

[Newl 

$$WORKING 7 50 QE) 

$$PERMANENT "750 CeD 

$$FILES-ONLY (f^FT 

$$ 



$ 
INSTEP 7: CREATE THE PS : <DECNET-SOURCES> DIRECTORY 

Create a directory for the DECnet sources. 
Type: 



$^ECREATE PS:<DECNET-SOURCES> C^ 

[New] 

$$WORK 7 50 C^^ 

$$PERM 7 50 GID 

$$FILES-ONLY QiT) 

$$ (J^ 

$ 
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INSTEP 8: CREATE A DECNET-TOOLS DIRECTORY 

If you do not already have a DECnet tools directory, create one. 

$'^ECREATE PS:<DECNET-TOOLS> CiiT) 

[New] 

$$WORK 200 r^JT) 
$$PERM 200 CreT) 
$$FILES-ONLY (TiT) 

$$ GiD 
$ 

i^STEP 9: CHECK FOR TAPE ALLOCATION ENABLED 

Use I SYS to determine if tape allocation is enabled for your system, 

$ I SYS GeD 
Operator is ... 



Tape-drive allocation is enabled 



^STEP 10: SELECT A TAPE DRIVE 



If tape-drive allocation is enabled use MOUNT TAPE; the example below 
uses MTAO: 

Type : 

$ MOUNT TAPE MTAO: CreT) 
[MTAO: assigned to MTO] 

If tape-drive allocation is not enabled, use ASSIGN MTAx : ; this 
example uses MTAO:. 

SASSIGN MTAO: CED 

Mount the DECnet-20 Distribution Tape on an available tape drive and 
put the drive on line. 
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NOTE 

If you are working on a stand-alone 
system, with the operator not in 
attendance, go to the operator*s console 
and enter the IDENTIFY command in the 
form shown below: 



OPR>IDENTIFY tape-id REQ reauest-id 



The s 

opera 

enter 

ident 

f iles 

assoc 

your 

to 

Langu 



peci 
tor ' 
ed 

if ie 
are 
iate 
logi 
the 
age 



discu 
comma 



ssio 

nds . 



fied request-id appears on the 
s console. ..The tape-id is 
in the form MTAn , where n 
s the tape drive from which the 

to be copied. The system 
s the physical device MTAn with 
cal assignment to MTn . Refer 

TOPS-20 Operator ' s Command 
Reference Manual for a complete 
n of IDENTIFY and the other OPR 



Note that the logical name used below 
may be your first or last name or any 
other valid string that you will be able 
to remember. 



INSTEP 11: RESTORE FILES FROM TAPE 



Use DUMPER to restore files from the distribution 
directories created on disk. 



tape to the 



• Remember to use PS : <NEW-SUBSYS> instead of <SUBSYS> and 
PS:<NEW-DECNET> instead of <DECNET> , if upgrading. 





NOTE 
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time . 











(TO) PS:<SUBSYS> QiD 



? DUMPER 
DUMPER>TAPE KTAO: GID 
DUMPER> REWIND C^ 

DUMPER> ACCOUNT (TiT ) (OF RESTOPED FILES FROM) cvs-eH-DEFJT'L"" ^^ 
DUMPER> RESTORE CTiQ (TAPE FILES) ps : Q^ <*>*'.T_* (tO)" <DEC\E^ 
(or to <NEW-DECNET> if upgrading) 
(Restores Documentation files.) 

DUMPER> RESTORE CK) 'TAPE FILES) ps • CE3 <*>* * 
(or to <NEW-SUBSYS> if upgrading) 
(Restores Binary files.) 

DUMPER>RESTORE QE3 '^APE FILES) pS:<DN20> CED *•*• 
(Restores DN20 Generation files) 

DUMPER>RESTORE (JED '^^PE FILES) ps : <DECNET-SOURCES> 

(Restores DECnet-20 source files) 

DUMPER>RESTORE QED (^APE FILES) pS:<TOOLS> (JED *■* 

(Restores DECnet-20 tools) 
DUMPER> REWIND (JJD 
DUMPER>EXIT (JTT) 
$ 



TO) PS:<DN2C> 

.*.* (TO) PS: <DECNET-SOURCE> QID 
(TO) PS: <DECNET-TOOLS> (JJ) 
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^ STEP 12: DISMOUNT THE TAPE 

If you have tape-drive allocation enabled, type: 
^DISMOUNT TAPE logical name: QID 

If you do not have tape-drive allocation enabled, type: 

^DEASSIGN MTAO: CeD 
1^ STEP 13: READ THE BEWARE FILE 

Before proceeding, read the DECnet-20 BEWAPE file, DECNET.BWR, you 
have restored to PS:<DECNET> or PS : <NEW-DECNET> . 

i^ STEP 14: CONNECT TO <DxxxxA> 

CONNECT to the front-end directory you have created. For example: 

^CONNECT <D2102A> (jeT) 

INSTEP 15: CREATE THE FILE DSK.CMD 

You must create a file called DSK.CMD to define the DSK: search list 

for a batch job you will submit later. Create DSK.CMD in the 

directory where you build the front-end, PS:<DxxxxA>. DSK.CMD must 
contain the entry: 

DEFINE DSK: DSK:, PS:<DN20> 

PS:<DN20> is the directory where you have restored the DN20 files from 
your DECnet-20 distribution tape. If you are using another directory 
for the DN20 files, specify that directory in DSK.CMD instead of 
PS:<DN20>. 

i^ STEP 16: RUN THE NETGEN PROGRAM 

Run NETGEN, which is the heart of the system generation procedure. 
Type: 

^NETGEN CiD 
NETGEN responds with an identifying message: 

TOPS-20 Network Configurator for DN20 or DN200, Version 3(56) 

[Type START to begin configuration dialog] 
The program prompts for each NETGEN command by displaying: 

NETGEN> 

The procedure shown in this section serves only as a model. You must 
use the NETGEN options that are appropriate to the hardware and 
software in your configuration. The specifications you enter with 
NETGEN must reflect the hardware at your site. Do not specify 
hardware devices not on your system. Use your Installation Worksheet. 
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1^ STEP 17: DISPLAY NETGEN DEFAULTS 

Display the node type default by issuing the INFOPMATION command. Use 
the LIST command to see the initial settings of all parameters. 



NETGEN> information (about) node r^iT) 

Node name is: (default) 

Node address is: (default) 

Node type is: DN20 (default) 

Line printers: (default) 

CRlls: (default) 
NETGEN> 

^STEP 18: SPECIFY YOUR PARAMETERS 

Describe your own configuration by entering your parameters. You can 
either use the dialog triggered by the START command, enter your own 
list of commands individually, or both. To use commands other than 
the START command, see Chapter 2, NETGEN. You will need to enter 
parameters summarized in the Installation Worksheet. With the START 
command, some parameters have defaults you can obtain with ( esc ) . 

Note that if you respond that there are KDPs on your DN2n, NETGEN 
immediately asks for information regarding the lines on the first KDP. 

For exam.ple, use the START command for the following dialog: 

NETGEN> START C^iT) 
Node type: DN2 dD 
Node name: NEWER (^T) 
Node address: 1 2 ( ret ) 



What DTE port number is used for this DN2n: 1 QID 

The total number of DMClls and DMRlls must not exceed 6 
How many DMCll lines are on this DN20: 1 CUD 
DMC-0 Duplex: full QiT) 
DMC-0 Cost: 2 (^HD 

How many DMRll lines are on this DN20: C ret ) 

How many KDPs are on this DN20: 1 ( "et ) 
Number of DUPll lines on this KDP: 2 (^T) 
KDP-0-0 Maximum Baud Rate: 19200 QiT) 
KDP-0-0 Cost: 3 CUD 

KDP-0-1 Maximum Baud Rate: 2400 C^eD 
KDP-0-1 Cost: 6 C^D 

[Configuration Saved On: PS : <D2102A>NEWER .CNF . 1] 
[Generating PS : <D2102A>NMLACC .MAC . 1] [OK] 
[Generating PS : <D2102A>CETAB .MAC . 1] [OK] 
[Generating PS : <D2102A>NETPAR. MAC .1 ] [OK] 

[Configuration complete] 

Type SAVE and FINISH after any additional changes 
Type EXIT to terminate NETGEN 

NETGEN> 
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INSTEP 19: CHECK THE PARAMETERS 

Check the current parameters for the DN2n to be sure that the node 
information is correct. If you m.ake no changes to the node 
information, you can EXIT from NETGEN as the output files have already 
been saved. 

( ESC ) 
I 

NETGEN>information (about) NODE ( ret ) 

Node name is: NEWER 

Node address is: 12 

Node type is: DN20 

Line printers: (default) 

CPUs: (default) 

NETGEN>list executor characteristics ( ret } 

Executor Node = 12 (NEWER) 

Identification = DECnet-20 V3 . Release 

Management Version = 3.0.0 

Loop Count = 1 

Loop Length = 127 

Loop With = Mixed 

Incoming Timer = 10 

Outgoing Timer = 30 

NSP Version = 3.2.0 

Maximum Links = 8 

Delay Factor = 2 

Delay Weight = 3 

Inactivity Timer = 30 

Retransmit Factor = 5 

Routing Version = 1.3.0 

Type = Routing 

Routing Timer = 60 

Maximum Address = 255 

Maximum Circuits = 4 

Maximum Cost = 100 

Maximum Hops = 16 

Maximum Visits = 32 

Buffer Size = 5^6 

Maximum Phase II Links = 20 

Phase II Transmit Password = DECNET20 



NETGEN>list known circuits characteristics C^!i 

Circuit = DTE-0-1 

Cost = 1 

Hello timer = 10 

Listen timer = 60 

Owner = Node / 2 / KKKLLL 

Line = DTE-0-1 
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NETGEN> list known lines characteristics ( ret ) 

Line = DTE-0-1 

Device = DTE-0-1 
Controller Register = 174440 
Interrupt Vector = 770 
Interrupt Priority = 7 
Pause Timer = 30 

Line = DMR-0 

Device = DMR-0 
Receive Buffers = 10 
Controller = Normal 
Duplex = Half 
Protocol = DDCMP-DMC 
Clock = External 
Service Timer = 3000 
Retransmit Timer = 3000 
Controller Register = 160740 
Interrupt Vector = 670 
Interrupt Priority = 5 

INSTEP 20: ADJUST THE PARAMETERS 

If you find any errors in the configuration described by the LIST or 
INFORMATION command, you can modify the NETGEN parameters until you 
are satisfied that your own configuration has been accurately 
described. Repeat steps 18 and 19 as many times as necessary. 

i^STEP 21: SAVE THE NETGEN RESULTS 

If you have used the START command, entered all the correct values, 
and made no changes to the NETGEN parameters, you can EXIT from NETGEN 
(use the EXIT command). The .CNF and .MAC files have already been 
saved. However, if you change any parameters, use the SAVE and FINISH 
commands before you exit from NETGEN. Otherwise your changes are 
lost. SAVE keeps the .CNF file, FINISH keeps all the others. 

If you do not specify an argument in the command, your results are 
saved in the file named PS : <DxxxxA>nodename. CNF , where PS:<DxxxxA> is 
your connected directory, and nodename is the node name (1-6 
characters) specified in the NETGEN procedure. Alternatively, you may 
specify the directory and/or file name. 

You may restore the configuration you create with the START command 
and make changes to it by using the RESTORE command. For example, 

\ 

NETGEN> restore (configuration from) ? input filespec 
NETGEN>restore (configuration from) PS : <DxxxxA>DxxxxA .CNF . 1 ( ret ) 
[Configuration Restored from PS : <DxxxxA>DxxxxA .CNF . 1 ] 
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Use DEFINE or INCLUDE commands, or whatever commands you need, to 
change devices on your configuration or to change any parameters. For 
example, the dialog in Step 18 shows a configuration of 2 DUPlls on 
KDP-b-0. To add a third DUPll, the following sequence would do the 
job: 

netgen>;restope newep.cnf CmD 

[Configuration Restored From: PS : <D2102A>NEWER .CNF . 1 ] 
NETGEN> exclude kdp ( mt ) 
NETGEN> include kdp fiiT) 
Number of DUPll lines on this KDP: 3 ( ret ) 
KDP-0-0 Maximum Baud Rate: 19200 Qif) 
KDP-0-0 Cost: 3 dD 

KDP-0-1 Maximum Baud Rate: 4800 C^D 
KDP-0-1 Cost: 5 (^J 

KDP-0-2 Maximum Baud Rate: 4 800 C ret ; 
KDP-0-2 Cost: 6 C^JT ) 
NETGEN>Save NEWEP.CNF CmT) 

[Configuration Saved On: PS : <D21022^>NEWER.CNF . 1 ] 
NETGEN> finished (with configuration) C ^^ ) 

[Generating PS : <D2102A>NMLACC . MAC . 2] [OK] 

[Generating PS : <D2102A>CETAB. MAC . 2] [OKI 

[Generating PS : <D2102A>NETPAR. MAC . 2] [OKI 
NETGEN>exit ( ret 







NOTE 






If you 


set any 


Manageme 


>nt Parameters 


(User, 


Account, 


Password) they 


are not 


restored 


when 


you use 


the 


RESTORE 


command. 


To retain them, 


use the 


DEFINE 


command 


whenever you 


change 


your 


configuration. 









If you want to change the configuration, you must repeat the above 
procedures to restore and change your file. 

INSTEP 22: FINISH THE NETGEN PROCEDURE 

To complete the configuration process, use the FINISH command in 
NETGEN. 

After you have saved the NETGEN results, you must finish the NETGEN 
configuration and exit from, the procedure. Type: 

i 

NETGEN>f inished (with configuration) CUD 
[Generating PS : <DxxxxA>NMLACC.MAC . 2] [OK] 
[Generating PS : <DxxxxA>CETAB.MAC . 2] [OK] 
[Generating PS : <DxxxxA>NETPAR. MAC . 2] [OK] 

NETGEN> 

This cauGCG NETGEN to write its output files. 
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If you have not issued a SAVE command, NETGEN displays: 

%Have you issued a SAVE command for this configuration? 

If you did not INCLUDE a synchronous line, NETGEN displays: 

%You have not configured any communications lines 

For more information on error messages, see Appendix A.l, NETGEN Error 
Messages. 

i^ STEP 23: EXIT FROM NETGEN 

To finish this part of your DN20 configuration, exit from NETGEN. 

NETGEN> exit QE) 
$ 

After you have concluded the NETGEN procedure, the following files are 
in your connected directory, PS:<DxxxxA>: 



Name 


File 


CETAB.MAC 
NMLACC.MAC 

nodename.CNF 
NETPAR.MAC 


Configuration file 

Node-specific access information 
for control of local NML functions. 
Remote sites must use this 
information when connecting to 
DECnet-20. 

Saved network configuration file 
(created if SAVE command was 
issued) 

System-specific parameters 



3.1.3 Creating Front-End Software 

^ STEP 24: SUBMIT THE DN20SYS.CTL FILE 

Submit the DN20SYS.CTL file, the control file supplied on your 
distribution tape, to the batch system. First reset its protection: 

$ SET FILE PROTECTION PS : <DN2 0>DN2 OSYS . CTL 777752 C^T) 

This changes the protection on the control file so it can be accessed 
by the batch system. 

$ SUBMIT PS:<DN20>DN20SYS.CTL/TIME:30/NOTIFY:YES CTJT ) 
The system displays a message in the form: 

[Job DN20SY Queued, Request-ID #60 Limit 00:30:00] 
When the job has completed, the system displays a message in the form: 

[From SYSTEM: Job DN20SY Request-ID #60 Finished Executing at hh:mm:ss] 
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This job does the followinq: 

lists logical names 

takes a check summed directory of all required files 

assembles MACRO-11 source modules 

creates TSKs and STBs (tasks and symbol tables) 

builds the DN20 system image, DxxxxA.SYS 

deletes OBJ files 

deletes the file NMLACC.MAC, having used it to create the 
system image 

INSTEP 25: CHECK THE DN20SYS.LOG FILE FOR ERRORS 

Examine the DN20SYS.LOG file produced by the batch job for two things: 

• fatal errors 

• system im.age larger than 124K 

The batch processor flags errors as follows: 



Flag 


Meaning 


? 

% 
] 


Fatal error 

Warning 

Comment 



For fatal errors: 

A successful job produces the DN20 system image; an unsuccessful 
job creates no system image. If your log file contains error 
messages, assembly errors, or undefined globals, determine the 
cause of the error, correct it, and resubmit the DN2nSYS.CTL 
file. 

For system-image size: 

Your DN20 system image may be too large. In the log file, 
examine the area under the heading "Build the DN2n systemL image." 
Find the words "The conjured system image is xxxK words. 
Considering buffers, yyyK words of memory will be required during 
execution." If the value of yyy is greater than 124, your system 
image is too large. To reduce the value to 124K or less, omit 
devices from your configuration or make the Buffer Size less than 
576. Rerun NETGEN to reduce the complexity of your DN20 
configuration, and repeat all subsequent steps in the procedure. 
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3.1.4 Putting the Files in System Directories 

INSTEP 26: COPY TO PS:<SUBSYS> OR PS : <NEW-SUBSYS> 

Put the DxxxxA.SYS file on PS:<SUBSYS> (or, if upgrading, on 
PS :<NEW-SUBSYS>) , with a copy command. For example: 

$COPY D2102A.SYS PS : <SUBSYS>D2 1 2A . SYS C^D 



3.1.5 Complete and Repeat the Configuration 

If you are configuring a system with remote job entry (PJE) 
facilities, you will have to perform the generation procedure for each 
remote station. Follow the procedures outlined in Section 3.2. If 
you are generating a system without the PJE capability, continue your 
system installation by skipping to Chapter 4. 

You must repeat the generation whenever you change the network 
configuration . 



3 . 2 REMOTE JOB ENTRY CONFIGURATION 

This section describes the procedures that you must follow to 
configure software for any DN200 remote job entry (PJE) stations 
connected to your DECSYSTEM-2040S/2 060 . In performing this 
configuration, you use the RJE distribution taoe described in Section 
1.3. ' 

This section is only relevant if your installation supports remote job 
entry. If your installation does not support RJE features, proceed to 
Chapter 4. 

Most of the steps performed for RJE configuration are basically the 
same as those performed for the DN20 (see Section 3.1). For PJE, 
however, you build the DN200 directory rather than the DN20 directory, 
and the <DN200x> directory rather than the DxxxxA directory. You 
should build a separate <DN200x> directory for each RJE station your 
system is to support. 



3.2.1 Generating RJE Software 

The remote configuration files are located on the RJE-20 distribution 
tape in the directory PS:<DN200>. Create a directory on disk named 
PS:<DN200> or, if upgrading from a previous version of DECnet-20, as 
PS : <NEW-DN200> . Later in the generation procedure, you will copy the 
generation files on the distribution tape to this disk directory. 
This is your RJE system directory. 
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INSTEP 27: CREATE THE PS:<DN200> DIRECTORY or <NEW-DN200> 

Type: 

$'^ECREATE PS:<DN200> C^T) 

[New] 

$$ WORKING 100 C^F) 

$$ PERMANENT 10 00 (^D 

$$ PROTECTION 777740 C^^T ) 

$$ FILES-ONLY C^^ 

$$ M AXIM UM 1 CliT) 

$$ CiD 

$ 

i^STEP 28: CREATE THE PS:<DN200x> and PS : <DN200x-DUMPS> DIRECTORIES 

Create two directories on disk for each RJE station. Call the primary 
directory PS:<DN200x>, where x is A for the first RJE station, B for 
the second, and so on. Each directory will contain only those files 
for the corresponding RJE node whose software you are building. Call 
the dump directory <nodename-DUMPS> , where nodename is the name of the 
DN200 node. This directory must be kept available to receive dumps of 
DN200 memory. When you create the dump directories, use passwords of 
your own choice. You must enter these passwords again when you run 
NIPGEN. Only the DN200 can initiate dum.ps. 

Type : 

$"ECREATE PS:<DN200x> dT) 

[New] 

$$ WORKING 7 50 CeD 

$$ PERMANENT 7 50 CmD 

$$FILES-ONLY (^7) 

$$ C^D 

S^ECREATE PS : <nodename-DUMPS> Q^ 

[New] 

$$ Work 1000 O^ 

$$ Perm lOOOQiT) 

$$ Pass [your choice] ( "Jt ) 

$$ Generations (TO KEEP) 5 ChD 

$$ C^D 

$ 

■^ STEP 29: CREATE THE PS : <DN200-SOURCES> DIRECTORY 

Create a directory named <DN200-SOURCES> to contain source code from 
the last saveset from the RJE-20 tape. 



Type 



$"ECREATE PS:<DN200-SOURCES> C^D 

[New] 

$$WORK 3 00 CeD 

$$PERM 300 CUD 

$$ FILES-ONLY (mT) 

$$ 
$ 
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INSTEP 30: RESTORE FILES FROM TAPE 



Use the DUMPER utility to restore files from the RJE-20 distribution 
tape to disk. The RJE-20 distribution tape contains three savesets: 
documentation, binaries, and sources for generation. Restore 
documentation to PS:<DECNET> (or PS : <NEW-DECNET> ) , binaries to 
PS:<SUBSYS> (or PS : <NEW-SUBSYS> if you are upgrading from DECnet-20 
V2.1 to DECnet-20 V3.0), and sources for generation to PS:<DN200>. 

• Mount the RJE-20 distribution tape on an available tape 
drive . 

• Use the INFOPMATION SYSTEM-STATUS command (see the TOPS-20 
Commands Reference Manual ) to determine whether tape 
allocation is enabled for your system. 

If tape-drive allocation is enabled, use MOUNT TAPE; the example 
below uses MTAO: 



Type 



$ MOUNT TAPE MTAO: C^T) 
[MTAO: assigned to MTO] 



If tape-drive allocation is not enabled, use ASSIGN MTAx : ; this 
example uses MTAO:. 

$ ASSIGN MTAO: dD 

Mount the RJE-20 Distribution Tape on an available tape drive and put 
the drive on line. 

$DUMPER C^T) 
DUMPER>TAPE MTAO: (^D 
DUMPER> REWIND CST ) 

I 

DUMPER>ACCOUNT (OF RESTORED FILES FROM) SYSTEM-DEFAULT Cli7 



I I 

DUMPER> RESTORE (TAPE FILES) PS: <*>*.*.* (TO) <DECNET> C^JT) 
(or to <NEW-DECNET> if upgrading) 
(Restores Documentation files.) 

( ESC ) 

DUMPER> RESTORE (TAPE FILES) PS : <SUBSYS> * . * (TO) PS : <SUBSYS> * . * C^T) 
(or to <NEW-SUBSYS> if upgrading) 
(Restores binaries) 

C^ C ESC ) 

I i 

DUMPER> RESTORE (TAPE FILES) PS:<DN200> *.*.* (TO) PS:<DN200> C^^ 
(or to <NEW-DN200> if upgrading) 
(Restores DN200 Generation files) 

C ESC ) ( ESC ) 

DUMPER>RESTORE (TAPE FILES) PS:<*>*.*.* (TO) PS : <DN2 00-SOURCES> C^ 
(Restores source files) 
DUMPER>REWIND C^JT) 
DUMPER>.EXIT (^J 
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NOTE 

If you are working on a stand-alone 

system with no operator in attendance, 
go to the operator's console and enter 

the IDENTIFY coinmand in thp form F^hown 
below: 

OPP IDENTIFY tape-id PEO request-id 



The 

oper 

ente 

iden 

file 

a sso 

your 

to 

Lanq 



spec 
ator 
red 
tif i 
s ar 
c ia t 
log 
the 
uage 



discussi 
commands 



ified request-id appears on the 
's console. The tape-id is 

in the form MTAn , where n 
es the tape drive from which the 
e to be copied. The system 
es the physical device MTAn with 
ical assignment to MTn . Refer 
TOPS-20 Operator 's Command 

Reference Manual for a complete 
on of IDENTIFY and the other OPP 



Note that the logical name used below 
may be your first or last name or any 
other valid string that you will be able 
to remember. 



INSTEP 31: DISMOUNT THE TAPE 

If you have tape-drive allocation enabled, type: 

$DISMOUNT TAPE logical name: C^ 
$ 

If you do not have tape-drive allocation enabled, type 

$DEASSIGN MTAO: CID 
$ 

Once your tape is rewound, remove it from the tape drive 
INSTEP 32: CONNECT TO <DN200x> 

Type: 

$ CONNECT PS:<DN2 00x> O^ 









NOTE 








Repeat 


Step 


s 32 


through 


41 


for each 


RJE 


station. 


Where 


the inst 


ructions 


refer 


to PS: 


<DN200x>, 
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INSTEP 33: RUN THE NETGEN PROGRAM 

Run NETGEN to define the DN200 configuration. Type: 

SNETGEN C^T) 
NETGEN responds with an identifying message: 

TOPS-20 Network Configurator for DN20 or DN20n, Version 3(55) 

[Type START to begin configuration dialog] 
The program then prompts for each NETGEN command by displaying: 

NETGEN> 

You may now enter any of the NETGEN commands to configure your DN200 
nodes . 







NOTE 






Ensure that 


yo 


u config 


Lire all n 


odes. 


For example 


r 


if you have three DN20n's| 


in your confi 


gurat ion , 


you must 


run 


NETGEN once 


for 


the DN20 


front-end 


while 


connected to 


PS 


:<DxxxxA> 


, and once 


for 


each of th 


e 


DN2nOs wh 


ile connected to| 


each directo 


ry 


PS:<DN200 


K>. Each 


node 


requires i 


ts 


own communication 


data 


base. 











INSTEP 34: SPECIFY DN200 PARAMETERS 



Specify NETGEN parameters which identify your DN200. You can use the 
dialog begun by the START command, or individual commands. You need 
always to specify: 

• The node type (DN200) 

• The name of the node 

• The address of the node 
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You might enter the following: 

NETGEN> start C«D 
Node type: dn20n Lel ) 
Node name: rjel ChD 

LxfwUc: OMiji-troo. ■^ ■■' \_ RET j 

Do you have a card reader on this DN200? no ( ret ) 

Do you have a line printer on this DN200? yes ( ret ) 

What is the comm.unicat ions line interfa ce on the DN200? 
Specify either DMCll or DMRll: dmcll C^D 

[Configuration Saved On: RJEl.CNF.l] 
[Generating PS : <DN200x>NMLACC .MAC . 3] [OK] 
[Generating PS : <DN200x>CETAB.MAC . 3] [OKI 
[Generating PS : <DN200x>NETPAR.MAC . 3] [OK] 

[Configuration complete] 

Type SAVE and FINISH after any additional changes 
Type EXIT to terminate NETGEN 

NETGEN>exit Q^ 
$ 

After you have identified the node as a DN200, NETGEN adjusts the 
default parameters to values appropriate for RJE stations. 



1^ STEP 35: CHECK THE PARAMETERS 



Check the output from the LIST or INFORMATION command to determine 
which parameters correctly describe your planned RJE configuration and 
which parameters must be changed. To change the physical link for a 
DN200, you may need to use the INCLUDE or EXCLUDE command. For 
example, 

EXCLUDE DMC 
INCLUDE DMR 

i 

NETGEN> information (about) NODE C^T) 

Node name is: RJEl 

Node number is: 68 

Node type is: DN200 

Line printers: 1 (default) 

CRlls: (default) 
NETGEN> 

INSTEP 36: ADJUST THE PARAMETERS 

Adjust the parameters displayed for the DN200 node to reflect any 
additions or changes to your configuration. For example, to include a 
card reader in the configuration, enter: 

NETGEN> include card-reader ( ret ) 

Repeat the previous two steps until the configuration parameters are 

satisfactory. 
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i^STEP 37: SAVE THE NETGEN RESULTS 



When the output from the LIST or INFORMATION command accurately 
describes your planned configuration, exit from NETGEN. If you have 
used the START command, entered all the correct values, and made no 
changes to the NETGEN parameters, you can EXIT from NETGEN (use the 
EXIT com.mand) . The .CNF and .MAC files have already been saved. 
However, if you change any parameters, use the SAVE and FINISH 
comm.ands before you exit from NETGEN. Otherwise your changes are 
lost. 

Check your output carefully. If you do not save the results and find 
that you must m.ake a correction after you issue the FINISHED command, 
you will have to rerun NETGEN from the beginning. 

When you are ready to save the NETGEN results, enter a SAVE command. 
If you do not enter an argument in the command, your results are saved 
in the file named PS : <DN200x>nodename . CNF , where nodename is the 
nodename you gave in the NETGEN procedure. Alternatively, you may 
specify the directory and/or filename. 

( ESC ) ( ESC ) 

i * 

NETGEN>save (configuration on) RJEl.CNF.l (^^ 
[Configuration Saved On: PS : <DN200x>RJEl . CNF . 1 ] 

You may restore the saved configuration at a later time by using the 
RESTORE command as follows: 



I 

NETGEN>restore (configuration from) ? input f ile spe c 
NETGEN>restore (configuration from) RJEl.CNF.l C^ 
[Configuration Restored From: PS : <DN200x>RJEl . CNF . 1 ] 







NOTE 








If you 


set any 


Manag 
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If you want to change the configuration, you must restore and change 
your configuration file. 

INSTEP 38: FINISH THE NETGEN PROCEDURE 

After you have saved the NETGEN results you must finish the NETGEN 
configuration and exit from the procedure. Type: 

C ESC ) 

I 

NETGEN>f mished (with configuration) C^) 

This causes NETGEN to write its output files. 
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If you have not previously issued a SAVE command, NETGEN displays the 
message: 

%Have you issued a SAVE command for this configuration? 

If you did not include a synchronons line when running NETGEN, NETGEN 
displays : 

%You have not configured any communications lines 

For more information on error messages, see Appendix A. 

Now type : 

I 

♦ 

NETGEN>exit (from NETGEN) C^D 

After you have concluded the NETGEN procedure, the following files are 
in your connected directory, PS:<DN200x>: 



Name 

CETAB.MAC 
nodename . CNF 

NMLACC.MAC 



File 



Configuration file 



Saved network configuration file (created if SAVE 
command was issued) 

Node-specific access information for control of 
local NML functions. 



NETPAR.MAC Sys tem-spec if ic parameters 

3.2.2 Creating RJE Software 
^STEP 39: SUBMIT THE DN200SYS.CTL FILE 



NOTE 

The control file DN2nnSYS.CTL used to 
build the DN200 image TAKEs a file named 
DSK.CMD. DSK.CMD defines the DSK: 
search list for the batch job. Before 
you SUBMIT DN20QSYS . CTL , create DSK.CMD 
in the <DN2n0x>d irectory . The DSK.CMD 
file should contain the entry: 

DEFINE DSK: DSK: , 
PS:<DN2 00>,PS:<DN2 0> 

PS:<DN20n> is the directory to which you 
restored the DN200 files from the RJE 
tape, and PS:<DN20> is the directory to 
which you restored the DECnet-20 files 
from the DECnet-20 tape. If you are 
using directories other than PS:<DN200> 
and PS:<DN2n> for the distribution 
directories, your DSK.CMD file m.ust 
specify your directories instead. 
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Submit the DN200SYS.CTL file, the control file from the RJE-20 
distribution tape, to the batch system. 

Enter the following: 

$ SET FILE PROTECTION PS : <DN2 00>DN2 OOSYS . CTL 777752 C^T) 

This changes the protection on the control file so the batch system 
can access it. 

$ SUBMIT PS : <DN2 >DN2 0SYS.CTL/TIME: 3 0/OUTPUT:NOLOG /NOTIFY: YES 
The system displays a message in the form: 

[Job DN200S Queued, Request-ID #61 Limit 00:30:00] 
This job does the following: 

lists logical names 

takes a checksummed directory of all required files 

assembles MACRO source modules 

creates TSKs and STBs (tasks and symbol tables) 

builds the DN20 system image, DN200x.SYS 

deletes OBJ files 

deletes the file NMLACC.MAC, having used it to create the 
system image 

You must submit this control file for each RJE station in your 
network . 



i^STEP 40: CHECK THE DN200SYS.LOG FILE 



Examine the DN200SYS.LOG file produced by the batch job for two 
things : 

• fatal errors 

• system image larger than 124K 
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For fatal errors: 

A successful job produces the DN200 system image. An 
unsuccessful job creates no system image. If your log file 
contains error messages, assembly errors, or undefined globals, 
determine the cause of the error, correct it, and resubm.it the 
DN200SYS.CTL file. 

For system-image size: 

Your DN200 system image may be too large. In the ] og file, 
examine the area under the heading "Build the DN200 system, 
image." Find the words "The conjured system image is xxxK words. 
Considering buffers, yyyK words of memory will be required during 
execution." If the value of yyy is greater than 124, your system 
im.age is too large. To reduce the value to 124K or less, omit 
devices from your configuration or make the Buffer Size less than 
576. Rerun NETGEN to reduce the complexity of your DN200 
configuration, and repeat all subsequent steps in the procedure. 



3.2.3 Putting Files in System Directories 

i^STEP 41: COPY TO PS:<SUBSYS> OR PS : <NEW-SUBSYS> 

For each RJE station, prepare a file in PS:<DN200x> that is free of 
errors. When done, copy all the individual DN200x.SYS files to 
PS:<SUBSYS> with copy commands, or, if upgrading, copy to 
PS :<NEW-SUBSYS>. Remember that the input file name and the directory 
name of each RJE system image is the same. Remember to copy to 
PS :<NEW-SUBSYS> if upgrading. For example: 

$COPY DN2 0A.SYS PS:<SUBSYS> Cm^ 
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CHAPTER 4 
NETWORK CHECKOUT 



This chapter describes how to setup the control and system files 
needed to check out DECnet capabilities between certain nodes in your 
network. 

Before you can load the nodes and test their connectivity, you must 
run the NIPGEN program described in this chapter. NIPGEN creates the 
command and control files utilized by the procedures discussed below. 

To perform verification and installation procedures, you must have a 
fully installed TOPS-20 operating system. Version 5.1 or later. This 
must be the system you will bring up at the beginning of Chapter 5. 
Before beginning the procedures described below, you must be logged in 
as a user with OPERATOR or WHEEL privileges, and have your privileges 
enabled . 

Because command files and control files and logical definitions may 
refer to certain files, you should ordinarily name and locate these 
files as shown in the descriptions and examples shown below. If your 
installation's conventions allow it, file names and locations m.ay be 
changed after the configuration and installation procedures have been 
successfully completed. You should be aware, however, that should you 
subsequently wish to reconfigure the system or to run validation or 
certification tests for diagnostic purposes, you will have to resolve 
references to files and data structures. 



4.1 NIPGEN OVERVIEW 

After you have created your front end and optionally your remote job 
entry (DN200) software, you are ready to describe the host and remote 
nodes and to verify and install the system. This chapter describes 
the interactive NIPGEN (Network Installation Procedure GENerator) 
program, which creates the command and control files used to verify 
your generated DECnet-20 node. The next chapter describes the 
detailed steps which you must follow to install the system. 

Before you invoke the NIPGEN program, you must ensure that you have 
configured your front end and RJE software and that the appropriate 
configuration files have been produced. You should have the following 
files on PS:<SUBSYS>, or, if upgrading, on PS : <NEW-SUBSYS> . 

• For the DN20: DxxxxA.SYS 

• For each RJE station: DN200x.SYS 

You must have a fully installed TOPS-20 operating system. Version 5.1 
or later. If you are upgrading. Version 5.1 need not be running until 
you reboot the system. 
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INSTEP 42: BE SURE YOU ARE CONNECTED TO <DxxxxA> 

To proceed with the next steps, be connected to <DxxxxA>. 
^ STEP 43: RUN NIPGEN 

Invoke the NIPGEN program typing: 

$ NIPGEN (^D 
in response to the TOPS-20 enabled prompt ($) . 
NIPGEN responds by displaying the following message: 

NIPGEN (V2.6) for DECnet-20 V3 . 

The program now prompts you to enter the name, address, and related 
information about the following nodes: 

• Host node 

• DN20 node 

• DN200 nodes 

• All remote nodes with which you plan to communicate 

The prompts and responses are described in the subsections that 
follow. 



INSTEP 44: SPECIFY YOUR HOST NODE 









NOTE 
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for a 
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NIPGEN first prompts you to enter information about your host node. 
For examDle: 



Host Node Address 

Name 

User Name 

Account 

Password 

Host Data Link 



120 C^D 

KL2102 
THE-USER QiT) 
341 C^D 

GUEST QID 
DTE-0-1 (^ST) 
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These entries must be specified as follows: 

• The host node address must correspond to the node address of 
the host TOPS — 20 comiputer at your installation. 

• The host node name must correspond to the node name of your 
TOPS-20 KL system. 

• The user name,, account, and password are your own, or a 
temporary set of, TOPS-20 name, account number, and password. 

• The host data link is the DTE20 device specification 
representing the interface between the DECSYSTEM 20408/2060 
and the DN20 front end. 

• You should have collected the information needed for NIPGEN 
in your Installation Worksheet. 

Note that in this chapter, node name examples follow the naming 
conventions for the front-end node described earlier. 



INSTEP 45: SPECIFY THE DN20 NODE 

Next, NIPGEN prompts you to enter the node address and name of the 
front end (DN20) node, as shown below. 

DN20 Node Address: 67 (^D 

Name: D2102A OiD 

User Name: Jake C^iD 

Account: 3 ( ret ) 

Password: JiH ChD 

The address and name must correspond to the specifications entered for 
the front end during the NETGEN procedure. The user name, account, 
and password must correspond to the values entered for the Management 
Parameters when running NETGEN. 

i^STEP 46: SPECIFY YOUR DN200 NODES 

Next, NIPGEN displays an informational message and prompts you to 
enter the node address, name, and data link of the DN200 nodes. If 
remote job entry is not supported for your configuration, simply 
respond to the prompt below by pressing ( ret ) : 

Terminate DN200 node address/name input 
questioning with a null node address. 

DN200 Node Address: (HD 

If you have generated one or more DN200s, enter node information in 
the following form: 

DN200 Node Address: 68 (^^ 

Name: RJEl C^D 

Host User Name: RJEl-DUMPS C^D 
Host Account: C«D 

Host Password: rick C^T) 

DN20 Data Link: DMC-0 C^D 
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The node address, name, and DN20 data link must correspond to the 
address, name, and link specified for this node with NETGEN. NIPGEN 
creates the host user name as nodename-DUMPS; you must enter the host 
password you used when creating the <nodename-DUMPS> directory in an 
earlier step. 

• The DN20 data link must correspond to the name and number of 
the synchronous line which serves as an interface between the 
DN200 and the front end. 

You must specify entries for all DN200's in your configuration. 

NIPGEN prompts for DN200 node information until you press RETURN in 
response to the prompt: 

DN200 Node Address: 

Note that you can correct a mistake in a DN200 node specification by 
reentering a previously specified node address in response to the 
"DN200 Node Address:" prompt. NIPGEN will replace the previously 
entered name and data link with the newly entered information. 



i^STEP 47: SPECIFY ADJACENT NODES IN YOUR NETWORK 



Next, NIPGEN displays an informational message and prompts you to 
enter information for the remote nodes in the network with which you 
want to communicate. Specify adjacent nodes you wish to test against. 

Terminate remote node address/name input 
questioning with a null node address. A 
file of pre-prepared inputs may be read 
via an indirect file, i.e., 

(apILENAME.EXT 

Remote Node Address: 1^3 Lel J 

Name: MILL2 CeD 

Phase III ? NO CID 

File Xfer (FAL) ? YES dD ^ 

User Name: SOME-USERC^D 

Account: MONITOR (^D 

Password: SECRET C^D 

These entries describe the remote node as follows: 

• For remote node address, enter the DECnet address of the 
remote node. 

• For name, enter the name of the remote node. 

• Enter YES for the Phase III entry if the current Phase III 
software is installed at this remote node; enter NO if Phase 
II software is installed. 

• Enter YES for the file Xfer (FAL) entry if the FAL (File 
Access Listener) program resides at the remote node and is 
used to process transfer requests initiated by the NET 
(Network File Transfer) program; enter NO if FAL is not 
used. Consider DECnet-20 hosts as Phase III nodes in answer 
to this question. 
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• Enter the user name, account, and password for any node using 
FAL. This information is not requested for nodes without 
FAL. 

You should have collected this information as part of your 
Installation Worksheet. 

NIPGEN continues to prompt you for remote node entries until you 
indicate that you are done by typing <PET> in response to the prompt: 

Remote Node Address: 

NIPGEN then creates the files described in Section 4.2 and responds by 
displaying the following: 

Writing CMD and CTL files 

NIPGEN Completed. 
$ 
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An example of entering remote node specifications is shown below 



Remote Node Address: 

Name : 

Phase III ? 

File Xfer (FAL) ? 

User Name: 

Account: 

Password : 

Remote Node Address: 

Name : 

Phase III ? 

File Xfer (FAL) ? 

User Name: 

Account: 

Password: 

Remote Node Address: 

Name : 

Phase III ? 

File Xfer (FAL) ? 

User Name: 

Account : 

Password : 

Remote Node Address: 

Name: 

Phase III ? 

File Xfer (FAL) ? 

User Name: 

Account: 

Password: 

Remote Node Address: 

Name : 

Phase III ? 

File Xfer (FAL) ? 

Remote Node Address: 

Name: 

Phase III ? 

File Xfer (FAL) ? 

User Name: 

Account: 

Password: 



103 dD 
MILL2n C^T) 

NO CiD 

YES ("517) 
SOME-USER (dlD 
MONITOR ChD 
SECRET CliT ) 

113 GeT) 
KL2137 C^T) 
YES r^JT ) 

YES r^JT ) 

ANOTHER-USER (m7) 

341 ( RET ) 

SHHH r^jT) 

116 dD 
KL2116 C^l) 
NO C^T) 
YES r^JT) 
A-USER (^T) 
341 C^F) 
QUIET (^^7) 

118 C^T) 
SYS880 (^T) 
YES r^JD 
YES ChD 
[200,200] CmD 

CID 

PRIVY ChD 



123 CiD 

D2137A 

YES CiD 
NO CID 



33 C^D 
VX1522 QST ) 
NO CiD 
YES C^T) 

SOME-USER CiD 

CiD 

SECRET C^D 



Remote Node Address: 

Writing CMD and CTL files 

NIPGEN completed 
$ 
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You can set up a command file to supply responses to the NIPGEN 
prom.pts for rem.ote node specifications. If you use such a file, you 
will not have to enter specifications from the terminal, as shown in 
the exam.ple above. Simply respond to the last remote node prompt with 
an @ and the filename and extension. An example is included below. 

Remote Node Address: (aNIPGEN.CMD QeD 

Writing CMD and CTL files — 

NIPGEN completed 
$ 

The contents of NIPGEN.CMD are shown below. 

103 

MILL20 
NO 
YES 

SOME-USER 
MONITOR 
SECRET 
113 

KL2137 
YES 
YES 

ANOTHER-USER 
341 
SHHH 
116 

KL2116 
NO 
YES 

A-USER 
341 
QUIET 
118 

SYS880 
YES 
YES 
[200,200] 

PRIVY 

123 

D2137A 

YES 

NO 

33 

VX1522 

NO 

YES 

SOME-USER 

SECRET 
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The final ( ret ) ends the list. If the command file contains 
specifications for a rem.ote node that has already been defined, the 
information in the file will supersede the previously entered 
information. If the command file contains a remote node specification 
for a node previously defined as the host, DN20, or DN200 node, the 
duplicate specification will be ignored. For convenience, you m.ight 
wish to set up a file which describes all of the nodes in the network, 
including your DN20 node. This file can then be invoked from any 
TOPS-20 node. 



4.2 NIPGEN COMMAND AND CONTROL FILES 

NIPGEN creates five com.mand and control files which are used to verify 
and load the configured nodes and to test connectivity to the 
specified remote nodes. These files are listed below and are 
discussed in greater detail in the subsections that follow. It is 
good practice to look at these files, to be sure they contain no 
errors, before using them. 



Name 



File 



NCP.CMD 



Command file defining the front end 
(DN20) data base for" input to OPR. 



NCPRJE.CMD 



Command file defining the remote job 
entry (DN200) data basefs) for input 
to OPR. 



NIPLCL.CTL 



Control file which will be used to 
verify host, front end, and DN200 
nodes. 



NIPNM.CTL 



Control file which will use the Phase 
III loopback facility for 
verification. 



NIPNFT.CTL 



Control file which will use NFT for 
Phase II and Phase III verification. 



4.2.1 NCP.CMD: DN20 Command File 

NCP.CMD is a command file which is input to the OPP program. It 
contains a series of com.m.ands which: 

• Define the node names and addresses of all of the nodes in 
the configured network in a format readable by the host 
system . 

• Define the data base for the network front end (DN20) . 
These definitions are made in the volatile data base. 
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A sample NCP.CMD file, based on the preceding input, is included 



INCP.CMD 



ENTER NOP 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
SET NODE 
RETURN 



67 NAME D2102A 

68 NAME RJEl 
103 NAME MILL20 
113 NAME KL2137 
116 NAME KL2116 
118 NAME SYS8B0 
120 NAME KL2102 
123 NAME D213 7A 
3 3 NAME VX1522 
D2102A CPU PDP-11 

D2102A SERVICE CIRCUIT DTE-0-1 

D2102A SECONDARY LOADER SYS rDTEMPS . SYS 

D2102A TERTIARY LOADER SYS : DTEMPT . SYS ■ 

D2102A LOAD FILE SYS :D2102A . SYS 

D2102A HOST KL2102 

D2102A SECONDARY DUMPER SYS :DTEDMP . SYS 

D2102A DUMP FILE SYS :D2102A .DMP 



4.2.2 NCPRJE.CMD: DN200 Command File 

NCPRJE.CMD is a command file which is input to the OPP program. It 
contains a series of commands which define the remote job entry data 
bases for all DN200's configured in the network. These definitions 
are made in the volatile data base; no permanent data base processing 
is performed for the DN200. 
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NCPRJE.CMD will be created only if one or more DN200 nodes were 
generated by NETGEN. A sample NCPRJE.CMD file is included below. 

1 

INCPRJE.CMD 



ENTER NCP 

SET EXECUTOR NODE D2102A USER JAKE PASSWORD JILL 

SET NODE 68 NAME RJEl 

WAIT 2 

SET NODE RJEl CPU PDP-11 

WAIT 2 

SET NODE RJEl SERVICE CIRCUIT DMC-0 

WAIT 2 

SET NODE RJEl HOST KL210 2 

WAIT 2 

SET NODE RJEl SECONDARY LOADER - 

KL2102"THE-USER GUEST 341 " : : SYS : DMCMPS . SYS 
WAIT 2 
SET NODE RJEl TERTIARY LOADER - 

KL2in2"THE-USER GUEST 3 41" : : SYS : DMCMPT . SYS 
WAIT 2 
SET NODE RJEl LOAD FILE - 

KL2102"THE-USER GUEST 3 41 " : : SYS : RJEl . SYS 
WAIT 2 
SET NODE RJEl DUMP FILE - 

KL2102"RJE1-DUMPS RICK ":: PS : <RJE1-DUMPS>RJE1 . DMP 
WAIT 2 

SET CIR KDP-0-2 SERVICE ENABLED 
WAIT 2 

CLEAR EXECUTOR NODE 
RETURN 



4.2.3 NIPLCL.CTL: Node Verification File 

NIPLCL.CTL is a control file which contains statements that perform 
the following operations: 

• Examines the host node 

• Examines the DN20 front end node. 

• Sets up the DN200 data base (if any DN2n0s were configured) . 

These statements are executed when you give the SUBMIT NIPLCL.CTL 
comm.and . 
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Check the batch log file, NIPLCL.LOG, for errors. The WAIT commands 
shov/n belov7 are included to ensure that res^^onses are entered in the 
log file. The WAIT interval may be tuned to shorten installation 
test ing = 

A sample NIPLCL.CTL file is included below. 



NIPLCL.CTL 

@ENABLE 

@NOEPROR 

(aOPR 

*ENTER NCP 

*SHOW EXECUTOR CHARACTERISTICS 

*WAIT 35 

*LOOP EXECUTOR COUNT 2 5 LENGTH 100 

*WAIT 35 

*LOOP NODE D2102A COUNT 25 LENGTH 100 

*WAIT 3 5 

*SET EXECUTOR NODE D2102A 

*WAIT 3 5 

*SHOW EXECUTOR CHARACTERISTICS 

*WAIT 3 5 

*LOOP EXECUTOR COUNT 25 LENGTH 100 

*WAIT 35 

*LOOP NODE KL2102 COUNT 25 LENGTH 100 

*WAIT 3 5 

*TAKE SYSTEMrNCPRJE 

*WAIT 35 

*EXIT 

Note that the last TAKE and WAIT lines above are not included if you 
did not specify a DN200 node. The first command to SHOW EXECUTOR 
CHARACTERISTICS gives information on the KL because whenever you enter 
NCP, the executor is set to the KL. 



4.2.4 NIPNM.CTL: Loopback Verification File 

NIPNM.CTL is a control file which contains statements that use the 
Phase III Network Management node loopback facility to verify 
connections to other Phase III nodes in the network. These statements 
are executed when you give a SUBMIT NIPNM.CTL command. 

Check the batch log file, NIPNM.LOG, for errors. The WAIT commands 
shown below are included to ensure that responses are entered in the 
log file. The WAIT interval may be tuned to shorten installation 
testing . 
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A sample NIPNM.CTL file is included below. 

NIPNM.CTL 

OENABLE 

(aNOERROR 

(aOPR 

*ENTER NCP 

*SHOW EXECUTOR CHARACTERISTICS 

*WAIT 35 

*LOOP NODE RJEl COUNT 25 LENGTH 100 

*WAIT 35 

*LOOP NODE KL2137 COUNT 25 LENGTH 100 

*WAIT 35 

*LOOP NODE SYS8 80 COUNT 2 5 LENGTH 100 

*WAIT 35 

*LOOP NODE D2137A COUNT 25 LENGTH 100 

*WAIT 3 5 

*SET EXECUTOR NODE D2102A 

*WAIT 35 

*SHOW EXECUTOR CHARACTERISTICS 

*WAIT 35 

*LOOP NODE 68 COUNT 25 LENGTH 100 !58 = RJEl 

*WAIT 35 

*LOOP NODE 113 COUNT 25 LENGTH 100 !113 = KL2137 

*WAIT 35 

*LOOP NODE 118 COUNT 25 LENGTH 100 !118 = SYS880 

*WAIT 3 5 

*LOOP NODE 123 COUNT 25 LENGTH 100 !123 = D2137A 

*WAIT 3 5 

*EXIT 



4.2.5 NIPNFT.CTL: NFT Verification File 

NIPNFT.CTL is a control file which contains statements that perform 
the following operations: 

• Use the Network File Transfer (NFT) facility to verify 
connections to Phase II nodes. 

• Provide an additional test for Phase III node connections. 
These statements are executed when you give the SUBMIT NIPNFT.CTL 
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Check the batch log file, NIPNFT.LOG, for errors. 
A sample NIPNFT.CTL file is included below. 

I 

INIPNFT.CTL 
I 

TENABLE 

^NOERROR 

(SDELETE NFTNIP.CTL 

(SNET 

*SET DEFAULTS MILL20:: - 

/ACCOUNT: MONITOR /USER : SOME-USER /PASSWORD : SECRET 
*COPY NIPNFT.CTL MILL2n:: 
*COPY MILL20: rNIPNFT.CTL NFTNIP.CTL 
*DELETE MILL20: :NIPNFT.CTL 
*EXIT 
@FILCOM 

*TTY:=NIPNFT.CTL, NFTNIP.CTL 
(SDELETE NFTNIP.CTL 
@NFT 
*SET DEFAULTS KL2137:: - 

/ACCOUNT: 341 /USER : ANOTHER-USER /PASSWORD : SHHH 
*COPY NIPNFT.CTL KL2137:: 
*COPY KL2137: :NIPNFT.CTL NFTNIP.CTL 
*DELETE KL2137: :NIPNFT.CTL 
*EXIT 
(SFILCOM 

*TTY:=NIPNFT.CTL, NFTNIP.CTL 
^DELETE NFTNIP.CTL 
@NFT 
*SET DEFAULTS KL2116:: - 

/ACCOUNT: 341 /USER:A-USER /PASSWORD : QUIET 
*COPY NIPNFT.CTL KL2116:: 
*COPY KL2116: :NIPNFT.CTL NFTNIP.CTL 
*DELETE KL2116: :NIPNFT.CTL 
*EXIT 
@FILCOM 

*TTY:=NIPNFT.CTL, NFTNIP.CTL 
laDELETE NFTNIP.CTL 
(SNFT 
*SET DEFAULTS SYS880:: - 

/ACCOUNT: /USER : [ 2 00 , 2 00] , /PASSWORD: PRIVY 
*COPY NIPNFT.CTL SYS880:: 
*COPY SYS880: rNIPNFT.CTL NFTNIP.CTL 
*DELETE SYS880: :NIPNFT.CTL 
*EXIT 
@FILCOM 

*TTY:=NIPNFT.CTL, NFTNIP.CTL 
^DELETE NFTNIP.CTL 
(SNFT 
*SET DEFAULTS VX1522:: - 

/ACCOUNT: /USER : SOME-USER /PASSWORD : SECRET 
*COPY NIPNFT.CTL VX1522:: 
*COPY VX1522: :NIPNFT.CTL NFTNIP.CTL 
*DELETE VX1522: :NIPNFT.CTL 
*EXIT 
@FILCOM 

*TTY:=NIPNFT.CTL, NFTNIP.CTL 
(SDELETE NFTNIP.CTL 
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INSTEP 48: COPY COMMAND FILES 



Copy the command files created by NIPGEN from your connected directory 
to PS:<SYSTEM>, or, if upgrading, to PS : <NEW-SYSTEM> . These files 
are: 

NCP.CMD: definitions for DN20 node 
NCPRJE.CMD: definitions for DN200 nodes 

Note that if your installation does not support remote job entry, 
there will be no NCPRJE.CMD file. 

To copy to PS:<SYSTEM>, enter the following from the EXEC: 

For the DN20: 

SCOPY (FROM) NCP.CMD (TO) PS : <SYSTEM>NCP . CMD ("mT) (or to PS : <NEW-SYSTEM> ) 

For the DN200: 

$COPY (FROM) NCPRJE.CMD (TO) PS : <SYSTEM>NCPRJE . CMD QeT) (or to PS : <NEW-SYSTEM> } 



4.3 SYSTEM FILE EDITS 

To set up your system to bring the network up automatically, you must 
edit certain system files. The files you must edit or create are: 

PTYCON.ATO (NETWRK.ATO) 
5-1-CONFIG.CMD 
SYSJOB.RUN 
SYSTEM.CMD 

When the system comes up, the monitor invokes CONFIG.CMD and runs 
SYSJOB. SYSJOB Starts PTYCON, executes commands in the PTYCON.ATO 
file and starts copies of LPTSPL and CDRIVE. PTYCON starts OPP and 
executes commands in SYSTEM.CMD and NCP.CMD (see Figure 4-1). 
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If you are upgrading froip a previous version of DECnet-20, use the 
<NEW-SYSTEM> directory in place of <SYSTEM>, and the <NEW-SUBSYS> 
directory in place of <SUBSYS>. Save the previous version on tape or 
disk until the current version runs successfully in a normal working 
environment . 



/Monitor comes up, 

runs x-SETSPD 
Uuses x-CONFIG CMD) > 



Monitor runs 
SYSJOB 

, (uses SYSJOB. RUN) 



-^ x-CONFIG.CMD 



Sets up KL 

nodename/ 

number 



SYSJOB.RUN 



Runs GALAXY 
modules 

Runs PTYCON 

GET 
PTYCON. ATO 



PTYCON.ATO 



Runs: 

NMLT20 

NODES 

MCBNRT 

FAL 

OPR TAKE 
SYSTEM.CMD 



TAKE NCP.CMD 



■♦ SYSTEM.CMD 



START 
RJE nodes 



NCP.CMD 



Set up 
database for 
network nodes 

Set up DN20 



MR-S-2289-82 



Figure 4-1 System Startup 
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INSTEP 49: EDIT AND RENAME NETWRK.ATO 



You must now set up PTYCON.ATO to start network programs on TOPS-20 
automatically when the system is restarted. You have received a 
NETWRK.ATO file on your DECnet-20 tape. It will be in PS:<SUBSYS> (or 
<NEW-SUBSYS> , if you are upgrading) if you have followed these 
procedures. NETWRK.ATO contains the commands to start the network 
support programs NMLT20, NODES, MCBNRT, and FAL. It also contains an 
OPR command to take the file SYSTEM.CMD, and the NCP command to SET 
SERVICE ENABLED on the DTE connected to your DN20. NETWRK.ATO 
contains : 

"X 

DEFINE "$NML 

CONN NML 

LOGIN OPERATOR FOO OPERATOR 

ENABLE 

SYS:NMLT20.EXE 

DEFINE "$NODES 

CONN NODES 

LOGIN OPERATOR FOO OPERATOR 

ENABLE 

SYSrNODES.EXE 

"X 

DEFINE "SMCBNRT 

CONN MCBNRT 

LOGIN OPERATOR FOO OPERATOR 

ENABLE 

SYSrMCBNRT.EXE 

'^X 

DEFINE "$FAL 

CONN FAL 

LOGIN OPERATOR FOO OPERATOR 

ENABLE 

SYS: FAL. EXE 

'^X 

CONN OPR 

LOGIN OPERATOR FOO OPERATOR 

ENABLE 

TAKE SYSTEM:SYSTEM.CMD 

NCP SET CIRCUIT DTE-0-1 SERVICE ENABLED 

''X 

If your DN20 is not on DTE number 1, you must edit NETWRK.ATO. Change 
the command 

NCP SET CIRCUIT DTE-0-1 SERVICE ENABLED 

to reference DTE-0-2 or DTE-0-3 as appropriate. 

If you have previously made changes to your PTYCON.ATO file, 
incorporate those changes into NETWRK.ATO. 
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If you want to collect CHKll output automatically, and have it logged, 
add the following lines to NETWRK.ATO after the SET SERVICE ENABLED 
command. This will place CHKll output in the PTYCON log file. 

DEFINE "SCHK 

CONN CHK 

LOGIN OPERATOR FOO OPERATOR 

TYPE DLl: 

"X 

Once you have all necessary commands in your NETWRK.ATO file, rename 
it as PTYCON. ATO and put it on PS:<SYSTEM>, or <NEW-SYSTEM> if you are 
upgrad ing . 

Type: 

SRENAME PS:<SUBSYS>NETWRK.AT0 PS : <SYSTEM>PTYC0N . ATO QlD 

(For information on PTYCON, see the TOPS-20 Operator' s Command 
Language Reference Manual . ) 
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i^STEP 50: EDIT CONFIG.CMD 



Your current CONFIG.CMD file must define the host node name and 
address for your KL. Insert the following line in 5-1-CONFIG. CMD: 

NODE hostnodename hostnodeaddress 

For example: 

NODE KL2102 120 

^STEP 51: FOR RJE STATIONS, EDIT SYS JOB. RUN 

If your system has no RJE stations, skip this step. 

For each RJE station your system supports, you must have a copy of 
LPTSPL running. If any RJE station has a card reader, you must also 
have a copy of CDRIVE running. 

For each RJE station, add to SYSJOB.RUN: 

RUN SYS: LPTSPL 

To support any card readers, you must have one copy of CDRIVE. 
Examine SYSJOB.RUN to see if it contains: 

RUN SYS: CDRIVE 

If not, add it. Also resolve any conflicts between entries in 

SYSJOB.RUN and PTYCON. ATO. For example, remove any reference to 

NETCON.EXE, that you may have used with an earlier version of 
DECnet-20. 
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i^STEP 52: FOR RJE STATIONS, EDIT SYSTEM.CMD 

If your system has no PJE stations, skip this step. 

For each RJE station your system supports, you must place a START NODE 
command in SYSTEM.CMD. The format of the OPR START NODE command is: 

START NODE nodename:: 

You must append the double colon. For example if the node name of 
your RJE station is RJE, enter: 

START NODE RJE: : 

These START NODE commands can be anywhere in SYSTEM.CMD. 

INSTEP 53: USE THE LATEST OPR 

DECnet-20 software interfaces with GALAXY software that runs with 
TOPS-20. Your new version of DECnet-20 software uses an OPR. EXE that 
has been built with the NCPTAB.REL for DECnet Phase III. The TOPS-20 
V5.1 Installation Tape includes an OPR. EXE built with GALAXY V4 . 2 and 
the DECnet Phase III NCP commands. By using this new OPR. EXE, you 
will have the correct NCP commands for DECnet Phase III. 

If you have applied patches to the field-image sources for OPR, you 
may not want to use the OPR. EXE supplied on the tape. If this is the 
case, you should relink your OPR files with the NCPTAB.REL supplied in 
PS:<SUBSYS> on the DECnet-20 Distribution Tape. Use the same 
procedures you used before when you rebuilt OPR. EXE, but use the new 
NCPTAB.REL. Be sure to save a backup copy of your old NCPTAB.REL in 
case you need to rebuild an OPR compatible with DECnet-20 Phase II. 

To rebuild NCPTAB.REL from the NCPTAB.MAC sources from the 
<DECNET-SOURCES> saveset on the DECnet-20 Distribution Tape, use the 
file NCPTAB.CTL. Then rebuild OPR using OPERAT.CTL and your new 
NCPTAB.REL. You can use OPERATOR. CTL only if all the correct 
universal files are on your system. If this is not the case, use the 
GALAXY. CTL file to rebuild all your GALAXY components. 

The standard procedure for shutting down and restarting the GALAXY 
system is described in the TOPS-20 Software Installation Guide . Check 
the GALAXY Beware file, if any, for additional pointers on this 
procedure. 



INSTEP 54: USE THE LATEST NET and FAL 



The versions of NET and FAL on the DECnet-20 V3 . tape have been built 

with GALAXY 4.2. To rebuild these programs with a different version 

of GALAXY, examine NFTFAL.CTL, resolve any logical name definitions, 
and submit it as follows: 

SUBMIT NFTFAL/TIME:0:30:00 

When the batch job completes successfully, move the new NFT.EXE and 
FAL. EXE to SYS: . 
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i^STEP 55: FOR RJE STATIONS, USE THE LATEST NURD.REL 



NURD.REL is reauired to build both LPTSPL.EXE and CDRIVE.EXE. Before 
you can use any DN200,- you must rebuild both LPTSPL and CDRIVE using 
the NURD.REL or NURD. MAC file supplied on the RJE-20 tape. The 
LPTSPL.EXE and CDRIVE.EXE shipped on the TOPS-20 V5.1 tape were NOT 
built with the latest version of NURD.REL. If you have followed these 
procedures, you have restored the source and control files needed to 
build NURD.REL from the fourth saveset of the RJE-20 to 
PS:<DN200-SOURCES>. 

Included with the GALAXY software on the TOPS-20 Monitor tape are the 
control files LPTSPL. CTL and CDRIVE. CTL. Use them to rebuild LPTSPL 
and CDRIVE. Read the instructions at the beginning of each control 
file to be sure you have all the required universal and source files 
in the correct directories. Then use a SUBMIT command with a 
reasonable time limit to submit the control files to the batch system. 

If you wish, you can use the GALAXY. CTL file to rebuild all GALAXY 
components instead of rebuilding only LPTSPL and CDRIVE. You should 
note, however, that rebuilding all GALAXY components takes about two 
hours and requires considerable disk storage. For more information on 
rebuilding GALAXY, see the TOPS-20 Software Installation Guide. 
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NETWORK NODE STARTUP 



INSTEP 56: SHUTDOWN AND REBOOT 



You now reboot the TOPS-20 system by performing a shutdown and 
bringing the system back up again. This will also bring up the 
network . 

To reboot the system in an orderly fashion, do the following: 

• Inform system users that timesharing will end in a specified 
time. 

• Shutdown the KLIO. 

• Reboot from disk. 

• Log in as usual to a directory with WHEEL or OPERATOR 
privileges. 

• ENABLE capabilities. 

• CONNECT to <DxxxxA> directory. 



NOTE 

If, in your edit to CONFIG.CMD, you have 
changed the nodename/nodenumber of the 
KL to be something other than TOPS-20 
and 64 (defaults for earlier versions of 
DECnet-20) , you may have batch and 
output queues with entries to be 
processed on the old "node". To get 
these processed with your new node, you 
must modify jobs, as appropriate, with 
PROCESSING-NODE or DESTINATION-NODE 
switches using the new node name. 



5.1 NODE CHECKOUT 

Once the TOPS-20 5.1 monitor is up and running, and you have been able 
to LOGIN as usual, verify that the network has been started by using 
the I DEC command. If your new monitor does not come up, you can try 
to reboot a second time. If it still fails to come up, revert back to 
the previous monitor (use the procedures described in the TOPS-20 
Software Installation Guide). Then check your TOPS-20 Installation 
Procedure to be sure your new monitor has been installed correctly. 
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ULSTER 57: GIVE THE I DEC COMMAND 



$1 DEC GiD 

Local DECnet node: KL2102 

Accessible DECNET nodes are: ABACUS ADAM CROW D2102A D2137A 

KL.2137 



5.2 NODE TROUBLESHOOTING 

If the TOPS-20 5.1 monitor is up and running, but your network has 
failed to come up, you can try to start the network manually. To do 
this, use OPR to DEFINE your network nodes and load the DN20. 



ii^STEP 58: DEFINE THE NODES 



Run the OPR program and then issue the TAKE NCP command. This causes 
the comm.ands in the NCP.CMD command file to be executed. These 
commands define the network topology (the logically adjacent nodes in 
the network) . 

$OPR QeT) 

Use the TAKE command to execute the commands in the NCP.CMD file. 

OPR>TAKE PS:<SYSTEM>:NCP C^tT) 
OPR> 

NCP.CMD will be on PS : <NEW-SYSTEM> if you are upgrading from a 
previous release. The first command in NCP.CMD is to enter NCP. 

INSTEP 59: LOAD THE DN20 

Load the DN20 front-end node using the Network Control Program (NCP) 
from OPR. Type: 

NCP LOAD NODE DxxxxA CED 

where DxxxxA is the name of your DN20 front end. This must be the 
name of your DN20 node. For example: 

OPR>NCP LOAD NODE D2102A QeT) 

Alternatively, instead of using NCP.CMD, you can transfer control from 
OPR to NCP by typing: 

OPP>ENTER NCP (jK) 
NCP>LOAD NODE DxxxxA ( ket ) 
NCP> 

After you issue this command, be sure that the load is successful 
before proceeding to the next step. If the load is successful, the 
following message is displayed on the system console: 

time stamp -- Network Node xxx is Online -- 
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If the load is not successful, determine the cause of the failure and 
correct it. CHKll is a module that resides in the DN20. It starts 
when the DN20 is loaded and outputs messages concerning available 
memory, the number and status of devices, and any detected errors. If 
you have difficulty bringing up the front end, use the following 
comm.ands to observe CHKll output: 

After the command: 

NCP>LOAD NODE DxxxxA CI^D 
Enter : 

NCP>PUSH CED 



TOPS-20 command processor 
gENAr^JT) 
$TYPE DLl: r^JT) 



6) 735 







NOTE 








Use 


DL2: if 


your DN20 


is on 


DTE no. 


2; 


use 


DL3: if 


your DN20 


is on 


DTE no. 


3. 


Using DLl, 2, 


or 3 requires 


that a 


DLll 


line connect 


the appropriate 


DN20 to 


the 


console front end. To 


see i 


f DLl, 2 


, or 


3 has been assigned in 


your 


system, 


use 




I L DLl 


(ret) 










System-wide: 










dll: =- 


> TTY202: 









At this point, CHKll output is displayed on your terminal 

For example: 

CHKll Hardware Test 

Version 3 (5) of 5-Jun-82 by rjp 

Testing begins... 

THE PROCESSOR SEEMS TO BE A KDll-E (11/34) 
CHKll EXPECTED an 11/34 

KTll memory management test 

PHYSICAL MEMORY HAS ABSOLUTE LIMITS OF 
- 757777 
FOR A TOTAL OF 124KW (DECIMAL) 

MAPPED PHYSICAL MEMORY TEST... 
. . . COMPLETE 

KWll-L checked 

device scan report assumes 

DN20 

DN21 

DN25 fixed assignments (no floating) 
2 Fixed DMClls from 160740, vector at 670 

CHKll complete 
DECnet-20 V3.0 
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NOTE 
CHKll reports DMRs as DMCs . 



DT.n 



"■s 2 Ic^icsl nsirns dGfincf 



■i-U^ rnor>r'_oo 



f 



i^_y i^iit X 'vJ h' L) — Z u ITiUniuuL^ Llie VcJlUe (J 

n represents the DTE20 to which your DN20 is connected. Each DN20 has 
a DLll-W that connects to a DLll-E on the console front end. This 
link is used for terminal input and output from the program executinq 
in the DN20. 



For example, as you can see if you execute the TOPS-20 monitor command 
I L A (information about Logical-names of All) , DLl : is defined as 
TTYxx:. The value of xx depends on the size of the monitor. 



When 

cont 

rece 

prog 

term 

to 

cont 

dire 

are 

the 



CHK 
roll 
ives 
ram 
inal 
the 
roll 
ct io 
sent 
path 



11 executes, 
ing terminal 
input from a 
running in 
, they cross 
inferior proc 
ing terminal 
n when chara 
to the progr 
of data from 



it receives input from and sends output to its 
; it also creates an inferior process that 
nd sends output to TTYxx:. Therefore, when the 

the DN20 outputs characters to be seen at the 
the DLll-E link (known to the monitor as TTYxx:) 
ess, which then sends the characters to the job's 
Analogous traffic occurs in the reverse 
cters entered from the job's controlling terminal 
am running in the DN20. Figure 5-1 illustrates 

the controlling terminal to the DN20. 




> 



C^ 






Z_ j. JDL11W 



> 



DL1-. = TTY102-. 
console I 

front end i . 



MEMORY 



TTY105: 



MR-S-2290-82 



Figure 5-1 Path from Terminal to DN20 

Once CHKll completes successfully, and the DN20 load is complete, you 
can exit from OPR and proceed to test your network setup. 



NCP>EXIT Oil 



If the DN20 node still fails to come up, you must revert back to the 
previous release. After doing so, examine the installation procedure 
to try to dcterm.ine the cause of the failure. DECnet-20 Version 2.1 
can run only with TOPS-20 Version 5.0; DECnet-20 Version 3.0 can run 
only with TOPS-20 Version 5.1. Be sure the system image for your DN20 
is not too large to load (check the DN20SYS.LOG file for this 
value - it must be less than 124K) . 
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i^ STEP 60: TEST THE HOST AND THE DN20 



Use the NIPLCL.CTL batch control file created by NIPGEN to perform the 
following operations: 

• SHOW EXECUTOP NODE CHARACTERISTICS of your KLIO host. 

• SHOW EXECUTOR NODE CHARACTERISTICS of your DN20. 

• Execute LOOP EXECUTOR COUNT and LOOP NODE COUNT commands. 

Submit the NIPLCL.CTL file to the batch system. Type: 

$SUBMIT NIPLCL.CTL QID 
$ 

If you submit this file from the system console you receive 

notification when the job is done. The normal time limit for this job 

is 05:00 minutes. Once the job is complete, the log file prints 
automatically . 

If you have built software for RJE-20 stations, you must wait for this 
batch job to complete successfully before proceeding to Section 5.3, 
RJE STARTUP. 

INSTEP 61: CHECK THE LOG FILE 

Check the batch job log file to be sure no errors occurred. If all is 
well, proceed; otherwise, find the cause of the errors, correct them, 
and resubmit the batch job. 

$TYPE NIPLCL.LOG QeT) 



5.3 RJE STARTUP 

To start up any remote stations in your network, you must communicate 
with the operators at the stations. 

INSTEP 62: LOAD THE DN200 

Do the following: 

1. At the host, run OPR and give the command: TAKE NCPRJE 

2. Ask the remote station operators to power down the 
appropriate RJE stations, if the stations are on. 

3. Ask them to power the stations up again. This initiates a 
station load. Any printer at the station should also be on 
and ONLINE. 

4. Wait until loading completes. Loading is done when you see 
the following message on your terminal. The same message 
also appears on the operator's console of each RJE station 
being loaded. Such a message appears for each station being 
loaded . 

timestamp -- Network Node xxx is Online -- 
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NOTE 






While loading of RJE 


stations is 


in 


progress, the DN20 


itself will 


not 


respond to commands as 


it is busy. 





The remote station operator can also press <CNTRL> <BOOT> on the DN200 
instead of performing steps 2 and 3, above. The power must be on for 
pressing <CNTRL><BOOT> to work. The operator at the remote station 
can also use the SHOW STATUS command to check status of the printer 
and card reader, if any. Printer and card reader should be "Idle" 
when not actively processing. Remember that you must have edited 
SYSJOB.RUN and SYSTEM.CMD to support your remote stations. 

Completing the above load procedure gets the DN200s loaded but does 
not ensure that they are all operating properly. You should check out 
typical RJE functions at this time. 



For example, you can use a TOPS-20 PRINT command to print a 
the RJE station. 



file at 



i^STEP 63: PRINT A FILE AT THE DN200 

For example, if the nodename of your RJE station is DN200, use the 
following command. Have a text file called text.txt ready to print. 

$PRINT text. txt/DESTINATION-NODE:DN200: : GiD 
[Printer job NCP aueued, request #94, limit 31 
$ 

See the TOPS-20 DN200 Remote Station Guide for more information on 
facilities at the RJE station. If the file prints correctly at the 
DN200, create a batch job on cards to read in at the DN200. Use the 
batch job and check that its log file returns correctly to the DN200. 

INSTEP 64: TEST PHASE III NODES 

Use the NIPNM.CTL batch control file created by NIPGEN to: 

• SHOW EXECUTOR NODE CHARACTERISTICS of your KLIO host and your 
DN20 front end. 

• Execute LOOP NODE commands between the KL host processor and 
adjacent Phase III nodes in the network. 



Execute LOOP NODE comm.ands between the DN2 
adjacent Phase III nodes in the network. 



i- i. Ull u 



end 



md 



Submit the NIPNM.CTL file to the batch system. Note that the time 
limit you use for this batch job depends on how many nodes you are 
testing. Allow about 1 minute per node. 

$SUBMIT NIPNM.CTL O^ 

[Batch job NIPNM queued, request #97, limit 0:05:00] 

$ 
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^STEP 65: CHECK THE LOG FILE 



If the batch job completes successfully, check the log file to be sure 
no errors occurred. If all is well, proceed; otherwise, find the 
cause of the errors, correct them, and resubmit the batch job. 

$TYPE NIPNM.LOG QiD 



5.4 FILE TRANSFER CHECKOUT 

■►step 66: TEST NFT/FAL NODES 

Use the NIPNFT.CTL batch control file created by NIPGEN to test file 
transfer between the KL host processor and adjacent nodes in the 
network that support NFT/FAL (Network File Transfer/File Access 
Listener). NIPNFT.CTL copies an ASCII file from one node to another 
and compares the output file with the input file. It does this task 
between the two adjacent TOPS-20 hosts. 

Submit the NIPNFT.CTL file to the batch system by typing the following 
from the EXEC: 

SSUBMIT NIPNFT.CTL CreT) 

[Batch job NIPNFT Queued, reauest #98, limit 0:05:001 

$ 



i^STEP 67: CHECK THE LOG FILES 



Type or print the log file generated by the batch job, examine the 
file for errors, and verify that file transfers have completed 
successfully. The output of file transfer checkout will be in: 

NIPNFT.LOG 

INSTEP 68: EDIT NCP.CMD TO DEFINE THE NODE DATABASE 

You must include in NCP.CMD, SET NODE commands that give the 
nodenumber-node name correspondence for all nodes in your network. Up 
to this point, you have provided this information for only the nodes 
against which you have tested. To build a complete NCP.CMD containing 
nodename-number correspondence for all nodes, you can either 

• edit the existing NCP.CMD or 

• rerun NIPGEN 

To edit NCP.CMD, add a line of the following form for each node not 
already in NCP.CMD: 

SET NODE nodenumber NAME nodename 

For example: 

SET NODE 25 NAME JAKE 
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If you prefer, run NIPGEN, enter the values for the DN20, do not enter 
values for any DN20ns, and enter only the following for each remote 
node in your network: 

Remote Node Address: 

Name : 

Phase III ?: n 

File xfer (FAL) ?: n 

Respond to the Phase III and File xfer prompts with n (NO). When you 
have entered the data for all the nodes in your network, exit normally 
from NIPGEN. NIPGEN will then create an NCP.CMD file containing 
entries for all nodes in your network. Discard the .CTL files, which 
contain no entries needed for the node data base. 

STEP 69: ACTIVATE THE NODE DATABASE 

To activate the node database while your system is running under 
normal timesharing, run OPR and take NCP.CMD. 

$opR GiD 

OPP>TAKE NCP GID 

This activates the node database normally. When the system is 
restarted, so long as your new NCP.CMD is in PS:<SYSTEM> (or 
PS:<NEW-SYSTEM) , it will be invoked. 



1^ STEP 70: PAUSE 



When you are satisfied with TOPS-20 Version 5.1 and DECnet-20 Version 
3.0, use the standard TOPS-20 method of making the new release the 
primary software. (See the TOPS-20 Software Installation Guide . ) 

This completes the DECnet-20 installation and verification procedures. 

If your network is running successfully, your system startup files all 
worked correctly, and your log files contain no errors, you are done. 
If some parts of your network are still not operational, you must 
resolve the errors and repeat the appropriate installation procedures 
to correct the software. 
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ERROR MESSAGES 



A.l NETGEN MESSAGES 

This appendix contains error messages that NETGEN displays. These 
messages can occur when you enter information to NETGEN, or when you 
try to SAVE the NETGEN files and EXIT from NETGEN. 

Address Must Be In Range 1 to 255 

The specified node address must be in the range 1 to 255. 

%BUFFER SIZE is being left as 290 (default is now 576) 

Warning message. You have used an old .CNF file created with the 

default of 290 for buffer size. Because the current default for 

buffer size is 576, NETGEN warns you about the difference but 
does not change the value. 

Cannot open log file 

?Cannot read file after open ok 

?Card Reader Not In Use 

You did not include a card reader for this configuration, and one 
is required. 

[Configuration Restored From: filename] 

[Configuration Saved On: filename] 

7DMC11 is already included, exclude it first 

You cannot include a DMCll more than once. 

7DMC11 not in configuration 

You have not included a DMCll in your configuration, so you 
cannot exclude it. 

PDMRll is already included, exclude it first 

You cannot include a DMRll more than once. 

7DMR11 not in configuration 

You have not included a DMRll in your configuration, so you 
cannot exclude it 
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Terror opening restore file 

PError opening save file 

PError Reading Restore File - Data Area Corrupted 

PError writing save file 

Have you issued a SAVE command for this configuration? 

This is a Warning Message. The SAVE command saves all your 
configuration parameters. If you exit from NETGEN without saving 
the configuration, and discover errors that require you to rerun 
NETGEN, you will have to configure the node from, the initial 
settings again. 

INFORMATION COMMAND - should never have gotten here. 

Plllegal to Exclude DMCll Other Than The Last One Included 

To determine the correct number, use the INFORMATION or LIST 
command . 

Plllegal to Exclude DMRll Other Than The Last One Included 

To determine the correct number, use the INFORMATION or LIST 
command . 

Plllegal to Include DMClls except in Numeric Order 

Use the INFORMATION or LIST command to find the last number you 
included . 

Plllegal to Include DMRlls except in Numeric Order 

Use the INFORMATION or LIST command to find the last number you 
included . 

Plllegal character in name 

A node name can contain alphabetic characters and numeric 
characters only. Special characters are not allowed. 

Plllegal to Exclude KDP Controller other than last one Included 

Use the INFORMATION or LIST command to find the number of the 
last KDP included. 

Plllegal to Include KDP Controllers except in numeric order 

Use the INFORMATION or LIST command to find the number of the 
last KDP included. 

PIncorrect DTE20 number 

The number you specified is outside the valid range (1 to 3). 

PInvalid KDP Controller Number 

The number you gave for the KDP Controller is outside the valid 
range (0 to 2) . ' 
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Plnvalid KDP number 

The number you gave for the KDP Controller is outside the valid 
range (0 to 2) . 

?Invalid line printer num.ber 

A DN200 can support one printer only. 

?Invalid number of DUPll lines, must be in range 1-4 

The number you gave for the number of DUPll lines is outside the 
valid range. Use a value from 1 to 4. 

?Invalid size of POOL 

?KDP Controller is already included, exclude it first 

You cannot include a KDP controller more than twice. 

?KDP not in configuration 

You have not included a KDP in your configuration, so you cannot 
exclude it. 

PKDPll Number Must Be In Range To 2 

PLength Of Save File Differs From Expected Length - Cannot Restore 
This File 

The file specified in a RESTORE command is the wrong length. 
Check your file specification. 

?Line printer not in use 

You have not included a Printer in your configuration, so you 
cannot exclude it. 

?Logging error 

%MAXIMUM ADDRESS is being left as 142 (default is now 255) 

Warning message. You have used an old .CNF file created with the 
default of 142 for maximum address. Because the current default 
for maximum address is 255, NETGEN warns you about the difference 
but does not change the value. 

%More than 8 communications lines on a DN20 is unsupported. 

You have included too many synchronous lines on your DN20. 
Name Must Contain At Least One Alphabetic Character 

A node name must contain at least one alphabetic character. 
Name too long: 

Node names must be six characters or less. 
?No such DUPll in this KDPll 
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?Nuinber of DMxll (DMC/DMR) Devices Exceeded - Cannot Add this DMCll 

The maximuni number of combined DMCll and DMRl 1 devices you can 
include is 6. 

?Number of D^xll (DMC/DMR) Devices Exceeded - Cannot Add this DMRll 

The maximum number of combined DMCll and DMRll devices you can 
include is 6. 

The maximum number of combined DMCll, DMRll, and DMP devices you 
can include is 6. 

%Physical address already in use 

■pphysical Address Must Be In Range 1 To 255 

Specify either DN20 or DN200 -- not xxxx 

Only DN2n and DN200 are valid node types. 

%The MAXIMUM ADDRESS and BUFFER SIZE parameters are inconsistent 
% BUFFER SIZE is being increased to xxx 

Warning message. The buffer size is (2* maximum address) +5, but 
not less than 290. You have used an old .CNF file created with 
old defaults; NETGEN warns you that it is changing the parameter 
according to the new rules. 

%The MAXIMUM VISITS and MAXIMUM HOPS parameters are inconsistent 
% MAXIMUM VISITS is being set from xxx to yyy 

Warning message. The maximum visits must be greater than or 

equal to the maximum hops. You have used an old .CNF file 

created with old defaults; NETGEN warns you that it is changing 
the parameter according to the new rules. 

?The Node Address has not been set 

Warning Message. Runnable software is created if you see this 
message, but you should set this parameter for each node. 

?The node address must be less than or equal to the number of nodes in 
the net. 

Fatal Error Message. The output files are not written. Check 
your node address. If the address is larger than the number of 
nodes in the network, your node will be unable to talk to its 
host, and all loads will fail. 

The node address requires a MAXIMUM ADDRESS of at least xxxx 

The node address you use and the maximum address you give must be 
compatible. Either correct one or the other. 

?The Node Name has not been set 

Warning Message. Runnable software is created if you see this 
message, but you should set this parameter for each node. 
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%The Node Number and MAXIMUM ADDRESS parameters are inconsistent 
% MAXIMUM ADDPESS is being increased to yyy 

Warning message. The node number cannot be greater than the 
MAXIMUM ADDRESS you have set. You have used an old .CNF file 
created with an old default; NETGEN warns you that it is 
changing this parameter according to the new rules. 

The number of nodes in the net requires a BUFFER SIZE of at least xxxx 

The number of nodes in the network and the BUFFER SIZE you use 
must be compatible. Change either one or the other. 

This system is not supported by DEC 

You have created software with parameters outside the allowed 
ranges. See the documentation describing configuration for the 
valid ranges. 

?Too many card readers 

You can have only one card reader on a DN200. 
?Too Many DMxll Devices - Can't Add The DN200's Default DMC 

A DN200 can have only one DMC/DMR. 
?Too many line printers 

You can have only one printer on a DN200. 

?Value is out of range: 

The value you have entered is too large. See the descriptions of 
individual NETGEN commands to review the allowed ranges. 

%Version Mis-Match - File Might Not Be Compatible 

Warning Message. You have specified a file in a RESTORE com.mand 
that may be the correct length, but the data in the file may not 
be compatible with the current software. Check your file 
specification, or rerun NETGEN. 

?You cannot include LPll or CRll devices on DN20s. 

A DN20 cannot be used to support unit record equipment. 

?You have not configured any communications lines. 

This is a Fatal Error Message. If you receive this message, the 
output files are not written. You have not included any 
synchronous lines (DMC ,DMR,KDP) for your DN20 node. The DN20 
configuration must include at least one synchronous line for 
communication with the network. 

%You have not included an I/O device for your DN200. 

Warning Message. Your DN200 will be loadable and will run 
without an I/O device (a printer or card reader), but it cannot 
fulfill its purpose without one. 
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?You have not specified any communications lines. 

Fatal Error Message. You must include at least one 
communications line for any node you are configuring. 

?Yoii have not configured a communications line (DMC/DMR) for your 
DN200. 

Fatal Error Message. The output files are not written. A DN200 
must have either a DMC or a DMR to communicate with the DN20. 
You must include one or the other when creating your 
configuration with NETGEN. 

?You must have only one comm.unicat ions line on the DN200, and that a 
DMC or DMR. 

Fatal Error Message. The output files are not written. A DN200 
can have only one line, included as a DMC or a DMR. If you have 
included more than one, exclude all but one. 

?Your DN20 has no DTE. 

Fatal Error Message. The output files are not written. A DTE 
link between your KLIO host and your DN20 is reauired. 



A. 2 NIPGEN MESSAGES 

This appendix contains error messages from NIPGEN. 

% Address already in use for node 

The address you have specified is already in use. Choose 
another. Node addresses must be unique in the network. 

% Can't open file 

The filename you have specified is incorrect. Either you have 
given the wrong filename, or the file you need is not where you 
expect it to be. 

% Node address out of range 

Node addresses must be within the allowed range, 1 to 255. Node 
addresses greater than 142 are not supported by DECnet-20. 

% Node names must contain from one to six characters 

A node name cannot be all numeric characters, and it cannot be 
more than six characters long. 

% Node names must contain at least one alpha character 

A node name cannot be all numeric characters. 
% Node nam.es m>ay contain only alphanumeric characlets 

A node name cannot contain special characters. 
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% Node name already assigned to node 

The node name you have specified is already in use. Node names 
must be unique in the network, so choose another name. 

% Please answer YES or NO 

You must answer YES ot NO to the prompt. 

Superseding with this new specification 

The last node specification you entered is superseding the 
previous one. 



A. 3 TKB36 AND VNP36 MESSAGES 

This appendix contains a list of messages that m.ay be produced by 
TKB36 and/or VNP36. A warning message starts with %, a fatal error 
message starts with ?. The messages are listed in alphabetical order. 

When a warning message appears, processing continues; however, 
subsequent processing may or may not be successful. If processing 
terminates some time after a warning message is issued, you should 
examine earlier warning messages. 

When a fatal error message appears, processing is always terminated. 

Replaceable arguments in both warning and fatal error messages are 
shown as abbreviations, shown below. 



Abbreviation 


Meaning 


addr 


octal address 




cmdl ine 


command line 




cntname 


controller name 




ddmname 


device driver module name 




d Icname 


data link controller name 




filename 


file name 




ft 


file type 




llcname 


logical link controller name 




modname 


module name 




objf ile 


object file name 




psect 


p-section name 




r tnname 


routine name (usually follows 
message text and two dashes) 


the 


symname 


symbol name 





ADDRESS OUT OF RANGE - STOll 

Attempting to OPEN an already OPEN channel - OPEN 

% Badly formatted OBJ file filename A -- routine-name A 

CALL TO GETSTG BEFORE INISTG 
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ERROR MESSAGES 

? Cannot find nnn D bytes in system pool in filename A 
routine-name A 

nnn is the number of decimal bytes requested. 

Channel is not OPEN - CLOSE 

Channel not OPEN - INPUT 

Channel not OPEN - OUTPUT 

Channel number out of range - INPUT 

Channel number out of range - OUTPUT 

% Checksum error in OBJ file filename A; should be nnn 0, was mmm 
-- routine-name A 

nnn is the octal value of the computed checksum. 

mmm is the octal value of the checksum that was read. 

CLOSE 

? Complex relocation exceeded stack limit of nnn D, file filename A 
-- routine-name A 

nnn is the stack limit in decimal. 

? Database Verification Error, Value 1= 

? DCP filename A is unknown -- routine-nam.e A 

? DDM filename A is unknown -- routine-name A 

% Divide by zero when resolving relocation in P-section filename A 
routine-name A 

EOF IGNORED IN SCAN 

? Error in text file filename A -- routine-name A 

Eval Called with Operand type 

? Failure freeing nnn bytes at addr in system pool in filename, code 
errcode -- routine-name 

nnn is the number of octal bytes in the block in question, 
errcode the decimal error code. 

Fatal Database Format Error — BLOCKLOAD 

? File filename A size of nnn D bytes is larger than max of mmm D 
routine-name A 

nnn is the file's size in decimal. 

mmm is the maximum permissible file size in decimal. 

% Global symbol routine-name A is undefined 

% Global symbol filename A is not defined in nnn A -- routine-nam.e A 
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ERROR MESSAGES 

? Illegal error 

This message indicates that the error number is out of the range of 

the defined error numbers. The "Terminating " message does not 

follow this message, as it does for all other error messages preceded 
by a question mark. 

? Indirect files nested too deep: "filename A" -- routine-name A 

? Input error or unexpected EOF -- routine-name A 

INPUT 

? Invalid address filename in file nnn A -- routine-name A 

Invalid Channel Number - OPEN 

Invalid Channel Number - CLOSE 

? Invalid contype - xxx found -- routine-name 

contype the type of construct that was found to be invalid. 
xxx is the decimal value of the invalid construct. 

? Invalid error 

ERROR MSG HAS NO TEXT 
? Invalid file name: "filename A" -- routine-name A 
? Invalid filename A nnn A mmm A ramm -- routine-name A 
? I/O DATA ERROR on filename A, status = nnn -- routine-name A 

nnn is the octal status of the I/O data error. 

? LLC filename A is unknown -- routine-name A 

? Loading library file filename A overflowed network pool by nnn D 
bytes -- $lA.b ? LOOKUP/ENTER UUO failed for filename^, code = nnn 
-- routine-name A 

May not OPEN channel - OPEN 

% Module filename A multiply defines P-section nnn A; flags = mmm 0, 
were nnn -- routine-name A 

mmm is the octal value of the new flags, 
nnn is the octal value of the old flags. 

NOT ENOUGH STORAGE FOR INITIALIZATION - INISTG 

? No input files -- routine-name A 

% Object file feature is unsupported -- routine-name A 

% Only one module allowed in symbol table file filename A 
routine-name A 
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ERROR MESSAGES 

? OPEN UUO failed for filename A -- routine-name A 

% Partition length of mmm less than task length of nnn -- rtnname 

mmm is the partition length in octal, 
nnn is the task length in octal. 

? Program logical address space (PLAS) is not supported 
routine-name A 

% Relocation value xxx truncated to 8 bits in P-section psect 
rtnname 

xxx is the octal value that was truncated. 

? Second nnn A file in command string: "filename A" -- routine-name 
A 

? Storage exhausted -- routine-name A 

? Switches must be associated with a file -- routine-name A 

? Symbol symname has conflicting values in symtabl and symtab2 
rtnname 

symtabl the first symbol table file. 
symtab2 the second symbol table file. 

? Syntax error in command line: "filename A" -- routine-name A 

PTerminating - No Recovery Available for Previous Error 

? The Communications Executive has already been loaded into kernfile 
-- routine-name 

kernfile the name of the kernel file 

? The top of the COMM EXEC is too high: ceaddr .GT. maxaddr in fn 
-- routine-nam.e 

ceaddr is the address of the top of the communications 

executive . 
maxaddr is the maximum permitted address of the RSXllS 

executive . 

% Unspecified output file: "filename A", ignored - routine-name A 

You May Not Close Channel - CLOSE 

? 22-bit memory management not supported in filename A 
routine-name A 
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APPENDIX B 
GLOSSARY 



computer network 



configuration 



configuration tools 

data link 
data link cost 



DMCll 



DMRll 



DN20 



DN200 



An interconnection of computer systems, 
I/O devices, and communications 
f acil ities . 

The process of custom.izing the DECnet 
software to use with the 
DECSYSTEM-20A0S/2060. Using the 
configuration tools, the DECnet user 
establishes the network parameters 
specific to the DECnet communications 
front end (and any RJE station) being 
configured. 

The programs NETGEN, NIPGEN, TKB36, 
VNP36, and DNMAC . These programs are 
needed for on-site configuration of 
DECnet-20 on a DECSYSTEM-2040S/2 060. 

A physical connection between two nodes. 

An arbitrary positive integer assigned 
to a physical path. Because the routing 
algorithm selects the least-cost path to 
a destination, an operator can 
dynamically affect the path to be taken 
by changing line costs. 

Single-line microprocessor-based 
interface to the network. The DMCll is 
a synchronous direct-memory-access 
device. 

Single-line multiprocessor-based 
interface to the network. The DMRll is 
a synchronous direct-memory-access 
device. 

A DECnet-20 communications front-end 
based on a PDP-11/34A. As used in this 
manual, DN20 is a generic term. 

A remote station based on a PDP-11/34A 
connected by a synchronous line to the 
DN20. The DN200 provides an operator's 
console, printer, and card reader. The 
software that runs on the DN200 is 
called RJE-20. 



DNMAC 



The cross-assembler 
source files. 



for PDP-11 macro 
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GLOSSARY 



DTE20 



DUMPER 



DUPll 



FAL 



The hardware interface between the 
KLIO-E main processor in a 
DECSYSTEM-2040S/2060 and the PDP-11 
processor in the DN20 communications 
front end. 

A TOPS-20 utility program, which is used 
to copy files from tape to disk. 

Single-line microprocessor-based 
interface to the network. The DUPll is 
a synchronous device. 

The File Access Listener, a program 
which resides on a local DECnet host and 
acts as the target for requests made by 
the NET program residing on remote 
DECnet hosts. 



hop 

host node 

inactivity timer 



instal lation 



KDP 



The logical distance between 
adjacent nodes in a network. 



two 



The network node at which a host 
computer provides services such as 
computation, data base access, special 
programs, or programming languages. 

The length of time, in seconds, that 
DECnet waits before exercising a logical 
link when there is no received traffic 
on the link. When the timer runs out, 
DECnet software sends a data request 
message over the logical link. If the 
message has not been acknowledged after 
a certain amount of time (see 
Retransmission Threshold) , the software 
decides that the physical network 
supporting the logical link has failed. 

DECnet installation is the process of 
setting up the DECnet software, 
specifying the node data base, and 
modifying several system files to 
include DECnet-related jobs. 

The combination of a KMCll controller (a 
microprocessor-based system) and from 
one to four DUPlls. With a KMC, a DUPll 
functions as a direct-memory-access 
device. 



local node 



A relative term indicating the node to 
which your terminal is attached. Your 
task usually executes at your local 
node. 



JLUylCdl ±iIlK 



A virtual data path between two tasks in 
a network that permits them to 
communicate. 
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GLOSSARY 



logical node 



The node to which the system sends a 
user's output. At login time, the 
logical node is the same as the physical 
node. The user m.ay specify a logical 
node away from the local node by using 
the SET LOCATION command at TOPS-20 
command level. 



loopback 



A mode of operation in which data 
transmitted by some task is reflected at 
some point along the communication path 
and returned to the originating task. 



maximum cost 



MCBNRT 
NCP 



The greatest total cost that the path to 
a node m.ay have if the node is to be 
reachable. When the cost associated 
with transmitting a message from one 
node to another exceeds the maximum 
cost, the transmission is not completed. 

Server for the SETHOST program. 

The Network Control Program that 
processes DECnet-20 network control 
com.mands. NCP is the OPR command set 
for network control. 



NETGEN 



The interactive Network Generation 
Program used to describe the hardware 
and software during the installation of 
a DECnet-20 node. 



network 



network diameter 



An interconnected or interrelated group 
of nodes. In this manual, network is 
synonymous with computer network. 

The reachability distance between the 
two nodes of the network having the 
greatest reachability distance; 
reachability distance is the length of 
the shortest path between a given pair 
of nodes. 



NET 



The Network File Transfer Program which 
allows you to access or delete files 
residing on DECnet hosts that provide 
network file access capabilities. NET 
initiates the service requests that will 
be carried out by the FAL program. 



NIPGEN 



The interactive Network Installation 
Procedure Generator Program used to 
create the command and control files 
used to verify and load configured 
nodes. 



NMLT20 



A specialized Network Management Task 
that accepts requests from operator 
commands and command files. NMLT20 
processes network control requests such 
as loading or dumping the communications 
front end, loading or dumping 
synchronous line controllers, and 
displaying line statistics for any line. 
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node A processor in the network. Every 

processor in the DECnet network is a 
node, whether it is a remote station, a 
communications front end, or a host 
itself. For DECnet-20 Version 3, a node 
IS an implementation of a computer 
system that supports transport, network 
services, and session control. Each 
node has a unique node address. 

node address A number uniquely identifying a node 

within a DECnet network. 

node name A 1- to 6-character name identifying a 

node within a network. Node names can 
be any combination of the characters A 
through Z and through 9 and must 
contain at least one alphabetic 
character . 

NODES The program that maintains information 

about on- and off-line status of DECnet 
nodes. This information is seen when 
the user gives an INFORMATION (About) 
DECNET command at TOPS-20 command level. 
NODES interrogates the process in the 
DN20 that contains on- and off-line 
status of every DECnet node, and 
communicates the status of all nodes to 
the KLIO. 

node type The type of node. When creating 

software for a DECnet-20 node using 
NETGEN, you specify the node type as 
either DN20 or DN200. 

OPR The Operator Command Language program 

that provides the operator with one 
command language to communicate with 
several TOPS-20 components. OPR 
processes commands for syntax and passes 
syntactically correct commands to the 
appropriate GALAXY com.ponent (QUASAR, 
ORION, or others) . 

packet A group of bits, comprising data and 

control information, which is 
transmitted as a composite whole over a 
physical link. The data, control 
information, and possibly error control 
information, are arranged in a specified 
format. 

path The route that a packet takes from the 

source node to the destination node. 

path cost The sum of the line costs along a path 

between two nodes. 

physical link A communications path between two 

adjacent nodes. This can be a dial-up 
line, leased line, radio link, satellite 
link, or a channel-to-channel connector 
such as a DTE20. 
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point-to-point link 



A type of network link in which two 

nodes are connected with a 

communications line and are the only 
nodes connected by that line. 



remote node 



A node in a network 
local node. 



that is not vour 



retransmission threshold 



The number of times NSP retransmits a 
message with no intervening received 
acknowledgement before deciding that the 
physical network supporting a logical 
link has failed. 



SETHOST 



A user program that lets the user access 
a remote TOPS-20 host across a DECnet. 



software ID 



The name of the DECnet software; the 
installer can supply this identification 
when running NETGEN. 



TKB36 



TKB3 6 



IS 



the 



task builder 



that 



constructs PDP-11 formatted task images 

from object files. TKB36 is used when 

generating the software for a DECnet-20 
or RJE-20 node. 



transmit password 



verification 



A 0-8 character password received by the 
remote node during an NSP initialization 
sequence. 

DECnet verification is the process of 
ensuring that the appropriate DECnet-20 
software modules have been installed. 
The verification process checks for the 
existence of each required module and 
for the correct version of each required 
module. 



VNP3 6 



VNP36 is the Virtual Network Program 
that creates the communication front end 
system image. VNP35 is used when 
generating software for a DECnet-20 or 
RJE-20 node. 



Volatile data base 



Dynamic 


values 


system 


is f i 


control : 


informat 


volatile 


data ba 


of these 


values 


SET. 


Volatile d 


when 


the 


system 


also 


be 


cleared 


data 


base is ca 


base 


in i 


some imp 



m memory, 
rst started, 
ion are read 
se. You may c 
using the NCP 
ata base value 
shuts down. 

or reset. Th 
lied the run 
lementations . 



When the 
data and 
into the 

hange many 
command , 

s are lost 
They may 

e volatile 

ning data 
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INDEX 



Accepting defaults, 1-14 
Access parameters, 2-4 
Activating node database, 

5-8 
Adjacent node, 

access parameters, 4-4 
address, 4-4 
FAL presence, 4-4 
name, 4-4 

specifying if Phase III, 
4-4 
Adjusting parameters 
(NETGEN) , 3-9 



Beware file, 1-4, 3-6 
Buffer size, 2-3 



Card reader for DN200, 2-5 
CDEIVE.CTL file, 4-19 
CDRIVE.EXE file, 4-19 
Checking DN20SYS.LOG file, 

3-12 
Checking parameters, 3-8 
CHKll output, 5-3 

example, 5-4 
Command files, 

copying, 1-8 

creation, 1-8 

for DN20, 4-8 

for DN200, 4-9 

NCP.CMD, 5-7 

NCPRJE.CMD, 5-5 
Command files (NIPGEN) , 4-! 
Computer network, 

defined, B-1 
CONFIG.CMD, 

edit, 4-17 
Configuration, 

defined, B-1 
Configuration tools, 

defined, B-1 
Control files, 4-19 

CDRIVE.CTL, ,4-19 

for node verification, 
4-11 

GALAXY. CTL, 4-19 

LPTSPL.CTL, 4-19 

NCPTAB.CTL, 4-18 

NFTFAL.CTL, 4-18 

NIPLCL.CTL file, 4-11, 
5-5 

NIPNFT.CTL, 4-12, 5-7 



Control files (Cont.) 
NIPNM.CTL, 4-12 
NIPNM.CTL file, 5-6 
OPERAT.CTL, 4-18 
OPERATOR. CTL, 4-18 
Control files (NIPGEN) , 4-8 
Conventions used in manual, 

vi 
Copying com.mand files to 

PS:<SYSTEM> or 

PS:<NEW-SYSTEM>, 4-14 
Copying DN200x.sys file(s) 

to PS:<SUBSYS> or 

PS:<NEW-SUBSYS>, 3-22 
Creating DECnet directory 

for sources, 3-3 
Creating DECnet directory 

for tools, 3-4 
Creating DECnet system 

directory, 3-3 
Creating DECnet 

system- specific 

directory, 3-3 
Creating DN200 image, 3-20 
Creating front-end (MCB) 

software, 3-11 
Creating RJE software, 3-20 



Data link, 

defined, B-1 
Data link cost, 

defined, B-1 
DECnet-20 V3 . , 

DN20 configuration, 3-1 

product description, 1-1 

requirements for, 1-2 
Defaults, 2-4 

accepting, 1-14 

displaying, 3-7 
DEFINE EXECUTOR command 
(NETGEN) , 

arguments, 2-10 

description, 2-10 

example, 2-10 
Defining network nodes, 5-2 
Directories , 

PS:<DN200-SOURCES>, 4-19 
Directories for DN20 

configuration, 3-2 
Directories to create, 1-3 
Distribution tapes, 1-2 

contents (DECnet-20) , 
1-12 

contents (DN200-RJE) , 
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Distribution tapes (Cont.) 

1-12 
DLll line, 5-3 
DLn: , 

defined, 5-4 
DMCll, 

defined, B-1 
DMClls, 

defined, 2-5 

number of, 2-5 
DMRll, 

defined , B-1 
DMRlls, 

defined, 2-5 

number of, 2-5 
DN20, 

defined, B-1 
DN20 (MCB) , 

generation of, 1-4 

loading, 5-2 
DN20 (MCB) node, 

failure to load, 5-4 
DN20 command file. See 

NCP.CMD file 
DN20 configuration, 3-1 

directories for, 3-2 

system setup for, 3-2 
DN200, 

configuration, 3-13 

defined, B-1 

generation of, 1-5 
DN200 (RJE) , 

adjusting parameters, 
3-18 

checking parameters, 3-18 

saving parameters, 3-19 

specifying parameters, 
3-17 
DN200 command file. See 

NCPRJE.CMD file 
DN200 node, 

access parameters, 4-3 

address, 4-3 

check operation, 5-6 

DN20 data link, 4-3 

name, 4-3 

startup, 5-5 
DN200SYS.CTL file, 

function of, 3-21 

submitting, 3-20 
DN200SYS.LOG file, 

checking, 3-21 

error m.essages, 3-22 
DN200X.SYS copy, 

example, 3-22 
DN20SYS.CTL file, 3-11 

functions of, 3-12 

submitting, 3-11 



DN20SYS.LOG file, 

checking, 3-12 

error messages, 3-12 
DNMAC , 

defined, 1-3, B-1 

use of, 1-3 
DSK.CMD file, 3-20 

creating, 3-6 
DTE20, 

defined, B-2 
DTE20 identification number, 

2-5 
DUMPER, 

defined, 1-3, B-2 

use of, 1-2 
DUPll, 

defined, B-2 
DUPlls, 

defined, 2-4 

number of, 2-4 
DxxxxA.SYS file, 3-13 

copying to directory, 
3-13 



Edit CONFIG.CMD, 4-17 
Edit for CHKll automatic 

output, 4-17 
Editing required, 4-16 
CONFIG.CMD, 4-17 
PTYCON.ATO, 4-16 
SYSJOB.RUN, 4-16 
SYSTEM.CMD, 4-16, 4-18 
Edits to files, 4-16 
Error messages (NETGEN) , 

2-8 
Error messages DN200SYS.LOG 

file, 3-22 
Error messages DN20SYS.LOG 

file, 3-12 
Examples, 

CHKll output, 5-4 
EXIT command (NETGEN) , 

3-11 
FINISHED command (NETGEN) , 

3-10 
INFORMATION command 

(NETGEN) , 3-8 
LIST command (NETGEN) , 

3-8 
NCP.CMD file, 4-9 
NCPRJE.CMD file, 4-10 
NIPLCL.CTL file, 4-11 
NIPNFT.CTL file, 4-13 
NIPNM.CTL file, 4-12 
remote node parameters, 
4-6 
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Examples (Cont.) 

RESTORE command (NETGEN) , 

3-9 
specifying parameters, 
3-7 
EXCLUDE command (NETGEN) , 
arguments, 2-11 
description, 2-11 
example, 2-11 
.EXE files and GALAXY 

version, 4-18 
EXIT command, 

for DN200 generation, 
3-20 
EXIT command (NETGEN) , 3-11 
description, 2-12 
example, 2-12, 3-11 
Exiting from NETGEN, 3-11 



PAL, 

defined, B-2 
FAL.EXE file, 4-18 
File Access Listener, 4-5 

in adjacent node, 4-5 
FINISHED command, 

for DN200 generation, 
3-19 
FINISHED command (NETGEN) , 
3-10 

description, 2-13 

example, 2-13, 3-10 
Finishing the NETGEN 

procedure, 3-10 
Front-end (MCB) software, 

generating, 3-3 



HELP command (NETGEN) 

(Cont.) 

example, 2-14 
Hop, 

defined, B-2 
Host node, 

access parameters, 4-3 

address, 4-3 

data link, 4-3 

defined, B-2 

name, 4-3 



I DEC command, 5-2 

example, 5-2 
ID, 

defined software, B-5 
Identification, 2-2 
Inactivity timer, 2-2 

defined, B-2 
INCLUDE command (NETGEN) , 

arguments, 2-15 

description, 2-15 

example, 2-15 
INFORMATION command 
(NETGEN) , 

arguments, 2-16 

description, 2-16 

example, 2-16, 3-8 
Installation, 3-1 

defined, B-2 
Installation worksheet, 

copy of, 1-15 

for DN20 (MCB) , 1-16 

for DN200, 1-16 

for nodes, 1-17 

use of, 1-14 



GALAXY version, 

.EXE files and, 4-18 
GALAXY. CTL file, 4-19 
Generating a Network. See 

network generation 
Generating front-end (MCB) 
software, 3-3 



KDP, 

defined, B-2 

KDPs, 

defined, 2-4 
number of, 2-4 

KLIO shutdown, 5-1 



Hardware, 

DLll, 5-3 

DN20 (MCB) , 1-15 

DN200, 1-15 

required order of 
addresses, 1-16 
Hardware environment, 1-2 
HELP command (NETGEN) , 

description, 2-14 



LIST command (NETGEN) , 2-1 

arguments, 2-17 

description, 2-17 

example, 3-8 

examples, 2-17 
Loading nodes, 1-8 
Local node, 

defined, B-2 
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LOG command (NETGEN) , 

arguments, 2-19 

description, 2-19 

example, 2-19 
Logical link, 

defined, B-2 
Loopback , 

defined, B-3 
Loopback verification, 

control file for, 4-11 
LPTSPL.CTL file, 4-19 
LPTSPL.EXE file, 4-19 



Management password, 2-4 
Manual , 

conventions used in, vi 

organization of, v 
Manual network node startup, 

5-2 
Maximum address, 2-3 
Maximum cost, 2-3 

defined, B-3 
Maximum hops, 2-3 
Maximum links, 2-2 
Maximum Phase-II links, 2-4 
Maximum visits, 2-3 
MCBNPT, 

defined, B-3 
Messages , 

NETGEN error messages, 
A-1 

Network node is online, 
5-2 

NIPGEN error messages, 
A- 6 

TKB36 messages, A-7 

VNP36 messages, A-7 



NCP, 

defined, B-3 

NCP.CMD file, 4-8 
editing, 5-7 
example, 4-9 

NCPRJE.CMD file, 4-8 
example, 4-10 

NETGEN, 

defined, 1-3, B-3 
use of, 1-2 

NETGEN command syntax, 2-9 

NETGEN commands, 2-6 
DEFINE EXECUTOR, 2-10 
error messages, 2-8 
EXCLUDE command, 2-11 
EXIT command, 2-12 
EXIT command (DN200) , 



NETGEN commands (Cont.) 

3-20 
FINISHED command, 2-13, 

3-10 
FINISHED command (DN200) , 

3-19 
HELP command, 2-14 
help feature, 2-6 
INCLUDE command, 2-15 
INFORMATION command, 2-16, 

3-7 
LIST command, 2-17, 3-8 
LOG command, 2-19 
NODE command, 2-20 
PURGE EXECUTOR command, 

2-21 
PUSH command, 2-22 
recognition feature, 2-6 
requesting arguments for, 

2-7 
requesting guidewords, 

2-7 
requesting list of, 2-6 
requesting value range, 

2-7 
RESTORE command, 2-23 
SAVE command, 2-24 
specifying parameters, 

3-7 
START command, 2-25, 3-7 
TAKE command, 2-26 
using recognition, 2-8 
NETGEN error messages, A-1 
NETGEN overview, 2-1 
NETGEN procedures, 
specifying DN200 

parameters, 3-17 
NETGEN program, 3-6 
error messages, 2-8 
for RJE, 3-17 
running, 3-6 
specifying parameters. 

Network , 

defined, B-3 
Network checkout, 4-1 
Network configuration, 

defined, 1-1 

directories required, 1-3 

DN20 (MCB) configuration, 
3-1 

DN20 (MCB) generation, 
1-4 

DN200 generation, 1-5 

for RJE, 3-13 

illustrations of, 2-5 

major steps, 1-1 

permanent storage 
required, 1-2 
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Network configuration 
(Cont.) 

preparation, 1-13 
priveleges for, 1-3 
procedure overview, 1-3 
time and place, 1-14 
tools, 1-2 
using TOPS-20 previous 

version, 3-1 
using TOPS-20 V5 . 1 , 3-1 
working storage required, 
1-2 
Network diameter, 

defined, B-3 
Network generation, 
manual startup, 1-8 
NETGEN commands, 2-6 
saving current parameters, 

2-24 
using command file, 2-25 
Network generation. See 
also Network 
configuration 
Network installation, 
installation worksheet, 
1-15 
Network node database, 1-9 
Network node startup, 5-1 
manual, 5-2 
verify, 5-2 
NETWRK.ATO, 

contents of, 1-8, 4-16 
editing and renaming, 
4-16 
NET, 

defined, B-3 
NET verification, 

control file for, 4-12 
NET. EXE file, 4-18 
NFT/EAL, 

check integrity, 1-9 
NFT/EAL nodes, 
testing , 5-7 
NIPGEN, 

defined, 1-3, B-3 
running, 1-8 
use of, 1-3 
NIPGEN command and control 

files, 4-8 
NIPGEN error messages, A-6 
NIPGEN procedure, 4-1 

activating node database, 

5-8 
checking before running, 

4-1 
checking command files, 

4-8 
checking control files, 
4-8 
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checking NIPLCL.LOG file, 
5-5 

editing NCP.CMD file, 5-7 

editing system files, 
4-16 

loopback verification, 
4-11 

NET verification, 4-13 

node verification, 4-11 

overview, 4-1 

running, 4-2 

specifying DN20 node 
parameters, 4-3 

specifying DN200 node 
parameters, 4-3 

specifying host node 
parameters, 4-2 

SUBMIT NIPLCL.CTL file, 
5-5 

SUBMIT NIPNM.CTL file, 
5-6 

testing NET/FAL nodes, 
5-7 
NIPGEN procedures, 

specifying adjacent node 
parameters, 4-4 
NIPGEN program, 

command files, 4-8 

function, 4-1 
NIPGEN.CMD file, 4-7 

using for NIPGEN 
responses, 4-7 
NIPLCL.CTL file, 4-10 

example, 4-11 

submitting, 5-5 
NIPLCL.LOG file, 

checking, 5-5 
NIPNFT control file, 1-9 
NIPNET.CTL file, 4-12 

checking, 5-7 

example, 4-13 

submitting, 5-7 
NIPNFT.LOG file, 4-13 
NIPNM control file, 1-8 
NIPNM.CTL file, 4-11 

example, 4-12 

submitting, 5-6 
NIPNM, LOG file, 

checking, 5-7 
NMLT20, 

defined, B-3 
Node, 

defined, B-4 
Node address, 2-2 

defined, B-4 
NODE command (NETGEN) , 

arguments, 2-20 

description, 2-20 
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(Cont.) 

example, 2-20 
Node database, 

activating, 5-8 
Node name, 2-1 

defined, B-4 
Node type, 2-1 

defined, B-4 
Nodes , 

defining, 5-2 

loading and verifying, 
1-8 
NODES program, 

defined, B-4 
NURD. MAC file, 4-19 
NURD. PEL file, 4-19 



OPEPAT.CTL file, 4-18 
OPERATOR. CTL file, 4-18 
OPR program, 

defined, B-4 
OPR. EXE file, 4-18 
Outgoing timer, 2-2 



Packet, 

defined, B-4 
Parameters , 

management, 2-4 
Parameters for NETGEN, 2-1 

defaults, 2-1 

described, 2-1 
Passwords , 

transmit, 2-4 
Path, 

defined, B-4 
Path cost, 

defined, B-4 
Phase-II transmit password, 

2-4 
Physical link, 

defined, B-4 
Point-to-point link, 

defined, B-5 
Preparing to confiqure, 

1-13 
Printer for DN200, 2-5 
PS:<DN20-SOURCES> directory, 

creating, 3-14 
PS:<DN200-SOURCES> 

directory, 3-14, 4-19 
PS:<DN200x-DUMPS> directory, 
3-14 

creating, 3-14 



PS:<DN200x> directory, 3-14 
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PS:<DxxxxA> directory, 3-9, 

3-10 
PS:<DxxxxA> directory, 

files contained in, 3-11 
Ps : <new-system> , 

PS:<SYSTEM> or, 4-14 
PS:<SUBSYS> or 

PS:<NEW-SUBSYS>, 
copying DN200x.sys 
file(s) to, 3-22 
copying DxxxxA.SYS to, 
3-13 
PS:<SUBSYS> or 

PS:<NEW-SUBSYS> 
directory, 3-13, 4-15 
PS:<SYSTEM> or 

ps: <new-system> , 4-14 
PS:<SYSTEM> or 

PS:<NEW-SYSTEM> 
directory, 4-15 
PURGE EXECUTOR command 
(NETGEN) , 
arguments, 2-21 
description, 2-21 
example, 2-21 
PUSH command (NETGEN) , 
description, 2-22 
example, 2-22 



Rebooting the TOPS-20 

system, 5-1 
Rebuilding CDRIVE.EXE (RJE 

only) , 4-19 
Rebuilding FAL.EXE, 4-18 
Rebuilding GALAXY 

components, 4-18 
Rebuilding LPTSPL.EXE (RJE 

only) , 4-19 
Rebuilding NCPTAB.REL, 4-18 
Rebuilding NFT.EXE, 4-18 
Rebuilding OPR. EXE, 4-18 
Reconfiguration facilities, 

2-9 
References , 

companion manuals, v 
Remote job entry 

configuration, 3-13 
Remote node, 

defined, B-5 
Remote node parameter 

specification, 4-6 
example, 4-6 
Remote station startup, 5-5 
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RESTORE command (NETGEN) , 
3-9 

arguments, 2-23 

description, 2-23 

example, 2-23, 3-9 

using, 2-9 
Restoring a configuration 

file, 2-23 
Retransmission threshold, 

defined, B-5 
Retransmit factor, 2-2 
RJE20 distribution tape, 

3-13, 3-15 
RJE20 distribution tape, 

restore files from, 3-15 
Routing timer, 2-2 
Running NETGEN, 

for DN200 (RJE) , 3-17 

parameters, 2-1 
Running nipgen, 4-2 
Running NIPGEN, 1-8 



START command (NETGEN) , 

description, 2-25 

example, 2-25 

using escape key, 2-25 
SYS JOB. RUN, 

editing, 4-16 
SYSJOB.RUN (RJE only), 

editing, 4-17 
System files, 

editing, 1-8 
System image size (DN20) , 

3-12 
System image size (DN200) , 

3-22 
System setup for DN20 

configuration, 3-2 
SYSTEM.CMD, 

editing, 4-16 
SYSTEM.CMD (RJE only) , 

editing, 4-18 



SAVE command (NETGEN) , 
argument, 2-24 
description, 2-24 
example, 2-24 
Saving current parameters, 

2-24 
Saving NETGEN results, 3-9 
SETHOST program, 

defined, B-5 
Shutdown , 

KLIO, 5-1 
Software , 

disk space required, 1-16 
tapes, 1-16 
Software environment, 1-2 
Software ID, 

defined, B-5 
Space allocations, 1-2 
Specify adjacent node 
parameters, 
example, 4-6 
Specifying adjacent node 

parameters, 4-4 
Specifying DN20 node 

parameters, 4-3 
Specifying DN200 node 

parameters, 4-3 
Specifying DN200 parameters, 

3-17 
Specifying host node 

parameters, 4-2 
Specifying your parameters 

(NETGEN) , 3-7 
Stand-alone system 
procedure, 3-16 



TAKE command (NETGEN) , 

argument, 2-26 

description, 2-26 

example, 2-26 
TAKE NCP.CMD file, 5-8 
TAKE NCPRJE.CMD, 5-5 
TKB36, 

defined, 1-3, B-5 

use of, 1-3 
TKB36 messages, A-7 
Transmit password, 2-4 

defined, B-5 



Using command files, 4-7 



V3.0, 

product description 
DECnet-20, 1-1 
Verification , 

defined, B-5 
Verify network node startup, 

5-1 
Verifying nodes, 1-8 
VNP36, 

defined, 1-3, B-5 

use of, 1-3 
VNP36 messages, A-7 
Volatile data base, 

defined, B-5 
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